Skip to main content

Get user limit request

GET 
/v1/compliance/user-limit-requests/:id

Get a limit request created by the authenticated partner for the end customer identified by the x-product-target-user-uuid header.

Request​

Path Parameters

    id stringrequired

    User limit request ID.

Header Parameters

    x-wallet-uuid string

    Sender Wallet UUID (if empty, your default Wallet UUID will be settled)

    nonce stringrequired

    The nonce ID is a UUID (v4) used to uniquely identify the request. All requests must have an identifier.

    x-product-uuid string

    UUID (v4) of the product that the request should use. Send it explicitly when the authenticated user has more than one product or when the integration must select a specific product. If omitted and the endpoint does not require it, the API uses the authenticated user's default product.

    x-product-target-user-uuid string

    UUID (v4) of the user on whose behalf the request should run within the selected product. If omitted, the request runs as the authenticated user. Requires x-product-uuid.

    x-lang string

    Possible values: [pt-BR, en-US]

    Indicates the preferred language. Defaults to Brazilian Portuguese if unspecified.

Responses​

The user limit request returned successfully. Returns null if the id is not found for the end customer.

Schema
    id stringrequired

    User limit request ID.

    status stringrequired

    Possible values: [OPEN, CLOSED]

    Request status. OPEN while it waits for the compliance analysis, CLOSED after the decision.

    analysis_result string

    Possible values: [APPROVED, REJECTED]

    Compliance decision. Only filled after the analysis.

    user_id stringrequired

    End customer the limit belongs to.

    requester_id stringrequired

    User who created the request.

    limit_type_tag stringrequired

    Limit type tag.

    period_type stringrequired

    Possible values: [DAILY, MONTHLY, YEARLY]

    Limit period the request changes.

    requested_value numberrequired

    Requested limit value in cents.

    current_value number

    Limit value in cents in force when the request was created.

    document_type stringrequired

    Possible values: [INCOME_TAX_RETURN, REVENUE_STATEMENT]

    Financial document type attached to the request.

    document_file_id stringrequired

    Storage file ID of the attached financial document.

    created_at date-timerequired

    Request creation date.

    closed_at date-time

    Date the request was closed.

    approved_value number

    Approved limit value in cents. Equal to or lower than the requested value; only filled after approval.

    reason string

    Reason given by compliance for the approval or rejection. Only filled after the decision.

Loading...