Skip to main content
POST
/
api
/
v1
/
accounts
Create a sub-account
curl --request POST \
  --url https://app.crown-brlv.com/api/v1/accounts \
  --header 'Content-Type: application/json' \
  --data '
{
  "tax-id": "12345678901",
  "tax-residence": "BRA",
  "kyc-attestation-id": "<string>",
  "external-wallets": [
    {
      "address": "0xabc...",
      "custody-country": "BRA",
      "custodian-name": "<string>"
    }
  ]
}
'
{
  "account": {
    "id": "019712cf-c86d-703f-85b8-bdaa4fc8d254",
    "alias": "Trading account",
    "status": "active",
    "external-id": "ext-12345",
    "created-at": "2024-01-15T10:30:00Z",
    "parent-id": "3c90c3cc-0d44-4b50-8888-8dd25736052a"
  }
}

Body

application/json
tax-id
string
required

Sub-account holder's tax id

Example:

"12345678901"

tax-document-type
enum<string>
required

Identity document backing the tax id (individuals only)

Available options:
passport,
national-id,
cpf
tax-residence
string
required

Tax residence country, ISO-3

Example:

"BRA"

kyc-attestation-id
string
required

Partner's reference to its own completed KYC of the holder

external-wallets
object[]

Response

An equivalent non-terminal request already exists

account
object
required