Create user or retry KYC

Production

POST

/v1/brl/createSubaccount

companyName, startDate and cnpj are only required when taxIdType is CNPJ

quoteId is optional: pass it in the normal ramp flow, or omit it for the quote-less KYB deep link where business verification starts before any quote exists.

Auth: secret X-API-Key or Supabase Bearer session.

Request

Authorization

API Key

Add parameter in header

X-API-Key

Example:

X-API-Key: ********************

Bearer Token

Provide your bearer token in the

Authorization

header when making requests to protected resources.

Example:

Authorization: Bearer ********************

Header Params

Body Params application/json

Examples

Responses

🟢200

application/json

Subaccount created or KYC retry initiated successfully.

Bodyapplication/json

🟠400

🔴500

🟠401ManagedSelectorUnauthorized

🟠403BrlaManagedSelectorForbidden

Request Example

Shell

JavaScript

Java

Swift

curl --location '/v1/brl/createSubaccount' \
--header 'X-Managed-Profile-Id;' \
--header 'X-API-Key: <api-key>' \
--header 'Content-Type: application/json' \
--data '{
    "accountType": "INDIVIDUAL",
    "name": "string",
    "quoteId": "string",
    "sessionId": "string",
    "taxId": "string"
}'

Response Example

200 - Example 1

{
    "subAccountId": "string"
}

Modified at 2026-08-19 18:12:56

Validate Pix key

Get user's KYC status