Create an individual account (kyc)

curl --request POST \
  --url https://app.crown-brlv.com/api/v1/accounts/kyc/individual \
  --header 'Content-Type: application/json' \
  --data '
{
  "identifiers": [
    {
      "value": "X1234567",
      "country": "PRT"
    },
    {
      "value": "07051368923",
      "country": "BRA"
    }
  ],
  "tax-residence": "BRA",
  "reward-tier": 97,
  "first-name": "Maria",
  "last-name": "Silva",
  "date-of-birth": "1990-04-12",
  "address": {
    "postal-code": "01310-100",
    "line1": "Avenida Paulista, 1000",
    "city": "Sao Paulo",
    "country": "BRA",
    "line2": "<string>",
    "state": "SP"
  },
  "document": {
    "front-file-id": "ev_019712CFC86D703F85B8BDAA4FC8D254",
    "back-file-id": "ev_019712CFC86D703F85B8BDAA4FC8D254"
  },
  "liveness": {
    "id": "<string>",
    "provider": "idwall"
  },
  "pep": {
    "declared": true,
    "full-name": "<string>",
    "role": "<string>"
  },
  "financial-profile": {
    "sector": "other",
    "currency": "BRL",
    "monthly-income": 12000,
    "net-worth": 850000,
    "source-of-funds": []
  },
  "email": "maria@example.com",
  "phone": "+5511999999999",
  "mother-full-name": "Ana Silva",
  "external-wallets": [
    {
      "address": "0xabc...",
      "capabilities": [
        "fx"
      ],
      "custody-country": "BRA",
      "custodian-name": "<string>",
      "owner-type": "third-party",
      "owner-name": "Acme Ltd"
    }
  ]
}
'

import requests

url = "https://app.crown-brlv.com/api/v1/accounts/kyc/individual"

payload = {
    "identifiers": [
        {
            "value": "X1234567",
            "country": "PRT"
        },
        {
            "value": "07051368923",
            "country": "BRA"
        }
    ],
    "tax-residence": "BRA",
    "reward-tier": 97,
    "first-name": "Maria",
    "last-name": "Silva",
    "date-of-birth": "1990-04-12",
    "address": {
        "postal-code": "01310-100",
        "line1": "Avenida Paulista, 1000",
        "city": "Sao Paulo",
        "country": "BRA",
        "line2": "<string>",
        "state": "SP"
    },
    "document": {
        "front-file-id": "ev_019712CFC86D703F85B8BDAA4FC8D254",
        "back-file-id": "ev_019712CFC86D703F85B8BDAA4FC8D254"
    },
    "liveness": {
        "id": "<string>",
        "provider": "idwall"
    },
    "pep": {
        "declared": True,
        "full-name": "<string>",
        "role": "<string>"
    },
    "financial-profile": {
        "sector": "other",
        "currency": "BRL",
        "monthly-income": 12000,
        "net-worth": 850000,
        "source-of-funds": []
    },
    "email": "maria@example.com",
    "phone": "+5511999999999",
    "mother-full-name": "Ana Silva",
    "external-wallets": [
        {
            "address": "0xabc...",
            "capabilities": ["fx"],
            "custody-country": "BRA",
            "custodian-name": "<string>",
            "owner-type": "third-party",
            "owner-name": "Acme Ltd"
        }
    ]
}
headers = {"Content-Type": "application/json"}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {'Content-Type': 'application/json'},
  body: JSON.stringify({
    identifiers: [{value: 'X1234567', country: 'PRT'}, {value: '07051368923', country: 'BRA'}],
    'tax-residence': 'BRA',
    'reward-tier': 97,
    'first-name': 'Maria',
    'last-name': 'Silva',
    'date-of-birth': '1990-04-12',
    address: {
      'postal-code': '01310-100',
      line1: 'Avenida Paulista, 1000',
      city: 'Sao Paulo',
      country: 'BRA',
      line2: '<string>',
      state: 'SP'
    },
    document: {
      'front-file-id': 'ev_019712CFC86D703F85B8BDAA4FC8D254',
      'back-file-id': 'ev_019712CFC86D703F85B8BDAA4FC8D254'
    },
    liveness: {id: '<string>', provider: 'idwall'},
    pep: {declared: true, 'full-name': '<string>', role: '<string>'},
    'financial-profile': {
      sector: 'other',
      currency: 'BRL',
      'monthly-income': 12000,
      'net-worth': 850000,
      'source-of-funds': []
    },
    email: 'maria@example.com',
    phone: '+5511999999999',
    'mother-full-name': 'Ana Silva',
    'external-wallets': [
      {
        address: '0xabc...',
        capabilities: ['fx'],
        'custody-country': 'BRA',
        'custodian-name': '<string>',
        'owner-type': 'third-party',
        'owner-name': 'Acme Ltd'
      }
    ]
  })
};

fetch('https://app.crown-brlv.com/api/v1/accounts/kyc/individual', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://app.crown-brlv.com/api/v1/accounts/kyc/individual",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'identifiers' => [
        [
                'value' => 'X1234567',
                'country' => 'PRT'
        ],
        [
                'value' => '07051368923',
                'country' => 'BRA'
        ]
    ],
    'tax-residence' => 'BRA',
    'reward-tier' => 97,
    'first-name' => 'Maria',
    'last-name' => 'Silva',
    'date-of-birth' => '1990-04-12',
    'address' => [
        'postal-code' => '01310-100',
        'line1' => 'Avenida Paulista, 1000',
        'city' => 'Sao Paulo',
        'country' => 'BRA',
        'line2' => '<string>',
        'state' => 'SP'
    ],
    'document' => [
        'front-file-id' => 'ev_019712CFC86D703F85B8BDAA4FC8D254',
        'back-file-id' => 'ev_019712CFC86D703F85B8BDAA4FC8D254'
    ],
    'liveness' => [
        'id' => '<string>',
        'provider' => 'idwall'
    ],
    'pep' => [
        'declared' => true,
        'full-name' => '<string>',
        'role' => '<string>'
    ],
    'financial-profile' => [
        'sector' => 'other',
        'currency' => 'BRL',
        'monthly-income' => 12000,
        'net-worth' => 850000,
        'source-of-funds' => [
                
        ]
    ],
    'email' => 'maria@example.com',
    'phone' => '+5511999999999',
    'mother-full-name' => 'Ana Silva',
    'external-wallets' => [
        [
                'address' => '0xabc...',
                'capabilities' => [
                                'fx'
                ],
                'custody-country' => 'BRA',
                'custodian-name' => '<string>',
                'owner-type' => 'third-party',
                'owner-name' => 'Acme Ltd'
        ]
    ]
  ]),
  CURLOPT_HTTPHEADER => [
    "Content-Type: application/json"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://app.crown-brlv.com/api/v1/accounts/kyc/individual"

	payload := strings.NewReader("{\n  \"identifiers\": [\n    {\n      \"value\": \"X1234567\",\n      \"country\": \"PRT\"\n    },\n    {\n      \"value\": \"07051368923\",\n      \"country\": \"BRA\"\n    }\n  ],\n  \"tax-residence\": \"BRA\",\n  \"reward-tier\": 97,\n  \"first-name\": \"Maria\",\n  \"last-name\": \"Silva\",\n  \"date-of-birth\": \"1990-04-12\",\n  \"address\": {\n    \"postal-code\": \"01310-100\",\n    \"line1\": \"Avenida Paulista, 1000\",\n    \"city\": \"Sao Paulo\",\n    \"country\": \"BRA\",\n    \"line2\": \"<string>\",\n    \"state\": \"SP\"\n  },\n  \"document\": {\n    \"front-file-id\": \"ev_019712CFC86D703F85B8BDAA4FC8D254\",\n    \"back-file-id\": \"ev_019712CFC86D703F85B8BDAA4FC8D254\"\n  },\n  \"liveness\": {\n    \"id\": \"<string>\",\n    \"provider\": \"idwall\"\n  },\n  \"pep\": {\n    \"declared\": true,\n    \"full-name\": \"<string>\",\n    \"role\": \"<string>\"\n  },\n  \"financial-profile\": {\n    \"sector\": \"other\",\n    \"currency\": \"BRL\",\n    \"monthly-income\": 12000,\n    \"net-worth\": 850000,\n    \"source-of-funds\": []\n  },\n  \"email\": \"maria@example.com\",\n  \"phone\": \"+5511999999999\",\n  \"mother-full-name\": \"Ana Silva\",\n  \"external-wallets\": [\n    {\n      \"address\": \"0xabc...\",\n      \"capabilities\": [\n        \"fx\"\n      ],\n      \"custody-country\": \"BRA\",\n      \"custodian-name\": \"<string>\",\n      \"owner-type\": \"third-party\",\n      \"owner-name\": \"Acme Ltd\"\n    }\n  ]\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.post("https://app.crown-brlv.com/api/v1/accounts/kyc/individual")
  .header("Content-Type", "application/json")
  .body("{\n  \"identifiers\": [\n    {\n      \"value\": \"X1234567\",\n      \"country\": \"PRT\"\n    },\n    {\n      \"value\": \"07051368923\",\n      \"country\": \"BRA\"\n    }\n  ],\n  \"tax-residence\": \"BRA\",\n  \"reward-tier\": 97,\n  \"first-name\": \"Maria\",\n  \"last-name\": \"Silva\",\n  \"date-of-birth\": \"1990-04-12\",\n  \"address\": {\n    \"postal-code\": \"01310-100\",\n    \"line1\": \"Avenida Paulista, 1000\",\n    \"city\": \"Sao Paulo\",\n    \"country\": \"BRA\",\n    \"line2\": \"<string>\",\n    \"state\": \"SP\"\n  },\n  \"document\": {\n    \"front-file-id\": \"ev_019712CFC86D703F85B8BDAA4FC8D254\",\n    \"back-file-id\": \"ev_019712CFC86D703F85B8BDAA4FC8D254\"\n  },\n  \"liveness\": {\n    \"id\": \"<string>\",\n    \"provider\": \"idwall\"\n  },\n  \"pep\": {\n    \"declared\": true,\n    \"full-name\": \"<string>\",\n    \"role\": \"<string>\"\n  },\n  \"financial-profile\": {\n    \"sector\": \"other\",\n    \"currency\": \"BRL\",\n    \"monthly-income\": 12000,\n    \"net-worth\": 850000,\n    \"source-of-funds\": []\n  },\n  \"email\": \"maria@example.com\",\n  \"phone\": \"+5511999999999\",\n  \"mother-full-name\": \"Ana Silva\",\n  \"external-wallets\": [\n    {\n      \"address\": \"0xabc...\",\n      \"capabilities\": [\n        \"fx\"\n      ],\n      \"custody-country\": \"BRA\",\n      \"custodian-name\": \"<string>\",\n      \"owner-type\": \"third-party\",\n      \"owner-name\": \"Acme Ltd\"\n    }\n  ]\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://app.crown-brlv.com/api/v1/accounts/kyc/individual")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["Content-Type"] = 'application/json'
request.body = "{\n  \"identifiers\": [\n    {\n      \"value\": \"X1234567\",\n      \"country\": \"PRT\"\n    },\n    {\n      \"value\": \"07051368923\",\n      \"country\": \"BRA\"\n    }\n  ],\n  \"tax-residence\": \"BRA\",\n  \"reward-tier\": 97,\n  \"first-name\": \"Maria\",\n  \"last-name\": \"Silva\",\n  \"date-of-birth\": \"1990-04-12\",\n  \"address\": {\n    \"postal-code\": \"01310-100\",\n    \"line1\": \"Avenida Paulista, 1000\",\n    \"city\": \"Sao Paulo\",\n    \"country\": \"BRA\",\n    \"line2\": \"<string>\",\n    \"state\": \"SP\"\n  },\n  \"document\": {\n    \"front-file-id\": \"ev_019712CFC86D703F85B8BDAA4FC8D254\",\n    \"back-file-id\": \"ev_019712CFC86D703F85B8BDAA4FC8D254\"\n  },\n  \"liveness\": {\n    \"id\": \"<string>\",\n    \"provider\": \"idwall\"\n  },\n  \"pep\": {\n    \"declared\": true,\n    \"full-name\": \"<string>\",\n    \"role\": \"<string>\"\n  },\n  \"financial-profile\": {\n    \"sector\": \"other\",\n    \"currency\": \"BRL\",\n    \"monthly-income\": 12000,\n    \"net-worth\": 850000,\n    \"source-of-funds\": []\n  },\n  \"email\": \"maria@example.com\",\n  \"phone\": \"+5511999999999\",\n  \"mother-full-name\": \"Ana Silva\",\n  \"external-wallets\": [\n    {\n      \"address\": \"0xabc...\",\n      \"capabilities\": [\n        \"fx\"\n      ],\n      \"custody-country\": \"BRA\",\n      \"custodian-name\": \"<string>\",\n      \"owner-type\": \"third-party\",\n      \"owner-name\": \"Acme Ltd\"\n    }\n  ]\n}"

response = http.request(request)
puts response.read_body

{
  "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"
  }
}

{
  "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"
  }
}

{
  "error": {
    "type": "<string>",
    "message": "<string>",
    "code": "<string>"
  }
}

{
  "error": {
    "type": "<string>",
    "message": "<string>",
    "code": "<string>"
  }
}

{
  "error": {
    "type": "<string>",
    "message": "<string>",
    "code": "<string>"
  }
}

{
  "error": {
    "type": "<string>",
    "message": "<string>",
    "code": "<string>"
  }
}

Accounts

Create Account (KYC, Individual)

Requests onboarding of an individual account whose KYC Crown runs itself.

The body carries the holder’s profile plus the identity document the partner collected. Its pages travel as ids: upload each one with POST /v1/accounts/files, then reference the returned id here.

Request-first: the response describes a creation request, not an account. The request enters compliance review and the account is provisioned on approval.

Every country code in the body is ISO 3166-1 alpha-3, read regardless of case: bra is read as BRA.

Validated on this request — every rule below is answered before anything is created, so no valid body needs a round trip to discover a condition:

The parent account must onboard accounts in kyc mode. A parent that onboards in reliance mode is refused with 403 and must use POST /v1/accounts/reliance.
The parent must hold the subaccounts-<tier>-tier capability matching reward-tier, or the request is refused with 403.
identifiers carries at most one entry per country. No entry carries a type.
A holder whose tax-residence is BRA must list their CPF under BRA, and may also list identifiers from other countries. A holder resident abroad must list an identifier from outside Brazil, and may add further identifiers, including the CPF they hold under BRA.
An entry under BRA must be a valid CPF.
date-of-birth must be the birth date of someone at least 18 years old.
address.state is required when address.country is BRA, where it must be the two-letter federal unit code (SP, RJ, MG, …). Elsewhere it is free text and optional.
document is required. Its type must be passport for any tax residence other than BRA; a BRA tax resident may send rg, cnh or passport. back-file-id is required when type is rg, and rejected for cnh and passport, which are each read from a single page.
When pep.declared is true, pep.full-name, pep.role and pep.relationship are all required.
When representative is sent, its identifier must not be the number that identifies the holder.
representative.identifier.country must be BRA exactly when representative.tax-residence is BRA. A BRA identifier is a CPF and must be a valid one; any other country identifies the representative by the passport that country issued. The representative’s identifier and residence are read on their own, not against the holder’s.
representative.document, representative.address and representative.pep follow the same rules as the holder’s document, address and pep.
Every file id referenced in document, representative.document and representative.power-of-attorney-file-id must have been uploaded by this same parent account via POST /v1/accounts/files.
external-wallets holds at most 5 wallets, and their addresses must be unique within the request.
A wallet whose capabilities is fx alone needs custody-type, custody-country (ISO-3) and owner-type. It needs custodian-name with exchange custody and refuses it with self, and needs owner-name with a third-party owner and refuses it otherwise.
Any other wallet accepts owner-type account-holder only, and no owner-name.
No address may already be another account’s external wallet. A wallet with fx alone may be one other accounts already receive FX payouts in; any other wallet may not.

Idempotency: sending the same holder again while its request is pending returns that request with 200, instead of creating a second one.

POST

api

accounts

kyc

individual

Create an individual account (kyc)

curl --request POST \
  --url https://app.crown-brlv.com/api/v1/accounts/kyc/individual \
  --header 'Content-Type: application/json' \
  --data '
{
  "identifiers": [
    {
      "value": "X1234567",
      "country": "PRT"
    },
    {
      "value": "07051368923",
      "country": "BRA"
    }
  ],
  "tax-residence": "BRA",
  "reward-tier": 97,
  "first-name": "Maria",
  "last-name": "Silva",
  "date-of-birth": "1990-04-12",
  "address": {
    "postal-code": "01310-100",
    "line1": "Avenida Paulista, 1000",
    "city": "Sao Paulo",
    "country": "BRA",
    "line2": "<string>",
    "state": "SP"
  },
  "document": {
    "front-file-id": "ev_019712CFC86D703F85B8BDAA4FC8D254",
    "back-file-id": "ev_019712CFC86D703F85B8BDAA4FC8D254"
  },
  "liveness": {
    "id": "<string>",
    "provider": "idwall"
  },
  "pep": {
    "declared": true,
    "full-name": "<string>",
    "role": "<string>"
  },
  "financial-profile": {
    "sector": "other",
    "currency": "BRL",
    "monthly-income": 12000,
    "net-worth": 850000,
    "source-of-funds": []
  },
  "email": "maria@example.com",
  "phone": "+5511999999999",
  "mother-full-name": "Ana Silva",
  "external-wallets": [
    {
      "address": "0xabc...",
      "capabilities": [
        "fx"
      ],
      "custody-country": "BRA",
      "custodian-name": "<string>",
      "owner-type": "third-party",
      "owner-name": "Acme Ltd"
    }
  ]
}
'

import requests

url = "https://app.crown-brlv.com/api/v1/accounts/kyc/individual"

payload = {
    "identifiers": [
        {
            "value": "X1234567",
            "country": "PRT"
        },
        {
            "value": "07051368923",
            "country": "BRA"
        }
    ],
    "tax-residence": "BRA",
    "reward-tier": 97,
    "first-name": "Maria",
    "last-name": "Silva",
    "date-of-birth": "1990-04-12",
    "address": {
        "postal-code": "01310-100",
        "line1": "Avenida Paulista, 1000",
        "city": "Sao Paulo",
        "country": "BRA",
        "line2": "<string>",
        "state": "SP"
    },
    "document": {
        "front-file-id": "ev_019712CFC86D703F85B8BDAA4FC8D254",
        "back-file-id": "ev_019712CFC86D703F85B8BDAA4FC8D254"
    },
    "liveness": {
        "id": "<string>",
        "provider": "idwall"
    },
    "pep": {
        "declared": True,
        "full-name": "<string>",
        "role": "<string>"
    },
    "financial-profile": {
        "sector": "other",
        "currency": "BRL",
        "monthly-income": 12000,
        "net-worth": 850000,
        "source-of-funds": []
    },
    "email": "maria@example.com",
    "phone": "+5511999999999",
    "mother-full-name": "Ana Silva",
    "external-wallets": [
        {
            "address": "0xabc...",
            "capabilities": ["fx"],
            "custody-country": "BRA",
            "custodian-name": "<string>",
            "owner-type": "third-party",
            "owner-name": "Acme Ltd"
        }
    ]
}
headers = {"Content-Type": "application/json"}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {'Content-Type': 'application/json'},
  body: JSON.stringify({
    identifiers: [{value: 'X1234567', country: 'PRT'}, {value: '07051368923', country: 'BRA'}],
    'tax-residence': 'BRA',
    'reward-tier': 97,
    'first-name': 'Maria',
    'last-name': 'Silva',
    'date-of-birth': '1990-04-12',
    address: {
      'postal-code': '01310-100',
      line1: 'Avenida Paulista, 1000',
      city: 'Sao Paulo',
      country: 'BRA',
      line2: '<string>',
      state: 'SP'
    },
    document: {
      'front-file-id': 'ev_019712CFC86D703F85B8BDAA4FC8D254',
      'back-file-id': 'ev_019712CFC86D703F85B8BDAA4FC8D254'
    },
    liveness: {id: '<string>', provider: 'idwall'},
    pep: {declared: true, 'full-name': '<string>', role: '<string>'},
    'financial-profile': {
      sector: 'other',
      currency: 'BRL',
      'monthly-income': 12000,
      'net-worth': 850000,
      'source-of-funds': []
    },
    email: 'maria@example.com',
    phone: '+5511999999999',
    'mother-full-name': 'Ana Silva',
    'external-wallets': [
      {
        address: '0xabc...',
        capabilities: ['fx'],
        'custody-country': 'BRA',
        'custodian-name': '<string>',
        'owner-type': 'third-party',
        'owner-name': 'Acme Ltd'
      }
    ]
  })
};

fetch('https://app.crown-brlv.com/api/v1/accounts/kyc/individual', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://app.crown-brlv.com/api/v1/accounts/kyc/individual",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'identifiers' => [
        [
                'value' => 'X1234567',
                'country' => 'PRT'
        ],
        [
                'value' => '07051368923',
                'country' => 'BRA'
        ]
    ],
    'tax-residence' => 'BRA',
    'reward-tier' => 97,
    'first-name' => 'Maria',
    'last-name' => 'Silva',
    'date-of-birth' => '1990-04-12',
    'address' => [
        'postal-code' => '01310-100',
        'line1' => 'Avenida Paulista, 1000',
        'city' => 'Sao Paulo',
        'country' => 'BRA',
        'line2' => '<string>',
        'state' => 'SP'
    ],
    'document' => [
        'front-file-id' => 'ev_019712CFC86D703F85B8BDAA4FC8D254',
        'back-file-id' => 'ev_019712CFC86D703F85B8BDAA4FC8D254'
    ],
    'liveness' => [
        'id' => '<string>',
        'provider' => 'idwall'
    ],
    'pep' => [
        'declared' => true,
        'full-name' => '<string>',
        'role' => '<string>'
    ],
    'financial-profile' => [
        'sector' => 'other',
        'currency' => 'BRL',
        'monthly-income' => 12000,
        'net-worth' => 850000,
        'source-of-funds' => [
                
        ]
    ],
    'email' => 'maria@example.com',
    'phone' => '+5511999999999',
    'mother-full-name' => 'Ana Silva',
    'external-wallets' => [
        [
                'address' => '0xabc...',
                'capabilities' => [
                                'fx'
                ],
                'custody-country' => 'BRA',
                'custodian-name' => '<string>',
                'owner-type' => 'third-party',
                'owner-name' => 'Acme Ltd'
        ]
    ]
  ]),
  CURLOPT_HTTPHEADER => [
    "Content-Type: application/json"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://app.crown-brlv.com/api/v1/accounts/kyc/individual"

	payload := strings.NewReader("{\n  \"identifiers\": [\n    {\n      \"value\": \"X1234567\",\n      \"country\": \"PRT\"\n    },\n    {\n      \"value\": \"07051368923\",\n      \"country\": \"BRA\"\n    }\n  ],\n  \"tax-residence\": \"BRA\",\n  \"reward-tier\": 97,\n  \"first-name\": \"Maria\",\n  \"last-name\": \"Silva\",\n  \"date-of-birth\": \"1990-04-12\",\n  \"address\": {\n    \"postal-code\": \"01310-100\",\n    \"line1\": \"Avenida Paulista, 1000\",\n    \"city\": \"Sao Paulo\",\n    \"country\": \"BRA\",\n    \"line2\": \"<string>\",\n    \"state\": \"SP\"\n  },\n  \"document\": {\n    \"front-file-id\": \"ev_019712CFC86D703F85B8BDAA4FC8D254\",\n    \"back-file-id\": \"ev_019712CFC86D703F85B8BDAA4FC8D254\"\n  },\n  \"liveness\": {\n    \"id\": \"<string>\",\n    \"provider\": \"idwall\"\n  },\n  \"pep\": {\n    \"declared\": true,\n    \"full-name\": \"<string>\",\n    \"role\": \"<string>\"\n  },\n  \"financial-profile\": {\n    \"sector\": \"other\",\n    \"currency\": \"BRL\",\n    \"monthly-income\": 12000,\n    \"net-worth\": 850000,\n    \"source-of-funds\": []\n  },\n  \"email\": \"maria@example.com\",\n  \"phone\": \"+5511999999999\",\n  \"mother-full-name\": \"Ana Silva\",\n  \"external-wallets\": [\n    {\n      \"address\": \"0xabc...\",\n      \"capabilities\": [\n        \"fx\"\n      ],\n      \"custody-country\": \"BRA\",\n      \"custodian-name\": \"<string>\",\n      \"owner-type\": \"third-party\",\n      \"owner-name\": \"Acme Ltd\"\n    }\n  ]\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.post("https://app.crown-brlv.com/api/v1/accounts/kyc/individual")
  .header("Content-Type", "application/json")
  .body("{\n  \"identifiers\": [\n    {\n      \"value\": \"X1234567\",\n      \"country\": \"PRT\"\n    },\n    {\n      \"value\": \"07051368923\",\n      \"country\": \"BRA\"\n    }\n  ],\n  \"tax-residence\": \"BRA\",\n  \"reward-tier\": 97,\n  \"first-name\": \"Maria\",\n  \"last-name\": \"Silva\",\n  \"date-of-birth\": \"1990-04-12\",\n  \"address\": {\n    \"postal-code\": \"01310-100\",\n    \"line1\": \"Avenida Paulista, 1000\",\n    \"city\": \"Sao Paulo\",\n    \"country\": \"BRA\",\n    \"line2\": \"<string>\",\n    \"state\": \"SP\"\n  },\n  \"document\": {\n    \"front-file-id\": \"ev_019712CFC86D703F85B8BDAA4FC8D254\",\n    \"back-file-id\": \"ev_019712CFC86D703F85B8BDAA4FC8D254\"\n  },\n  \"liveness\": {\n    \"id\": \"<string>\",\n    \"provider\": \"idwall\"\n  },\n  \"pep\": {\n    \"declared\": true,\n    \"full-name\": \"<string>\",\n    \"role\": \"<string>\"\n  },\n  \"financial-profile\": {\n    \"sector\": \"other\",\n    \"currency\": \"BRL\",\n    \"monthly-income\": 12000,\n    \"net-worth\": 850000,\n    \"source-of-funds\": []\n  },\n  \"email\": \"maria@example.com\",\n  \"phone\": \"+5511999999999\",\n  \"mother-full-name\": \"Ana Silva\",\n  \"external-wallets\": [\n    {\n      \"address\": \"0xabc...\",\n      \"capabilities\": [\n        \"fx\"\n      ],\n      \"custody-country\": \"BRA\",\n      \"custodian-name\": \"<string>\",\n      \"owner-type\": \"third-party\",\n      \"owner-name\": \"Acme Ltd\"\n    }\n  ]\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://app.crown-brlv.com/api/v1/accounts/kyc/individual")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["Content-Type"] = 'application/json'
request.body = "{\n  \"identifiers\": [\n    {\n      \"value\": \"X1234567\",\n      \"country\": \"PRT\"\n    },\n    {\n      \"value\": \"07051368923\",\n      \"country\": \"BRA\"\n    }\n  ],\n  \"tax-residence\": \"BRA\",\n  \"reward-tier\": 97,\n  \"first-name\": \"Maria\",\n  \"last-name\": \"Silva\",\n  \"date-of-birth\": \"1990-04-12\",\n  \"address\": {\n    \"postal-code\": \"01310-100\",\n    \"line1\": \"Avenida Paulista, 1000\",\n    \"city\": \"Sao Paulo\",\n    \"country\": \"BRA\",\n    \"line2\": \"<string>\",\n    \"state\": \"SP\"\n  },\n  \"document\": {\n    \"front-file-id\": \"ev_019712CFC86D703F85B8BDAA4FC8D254\",\n    \"back-file-id\": \"ev_019712CFC86D703F85B8BDAA4FC8D254\"\n  },\n  \"liveness\": {\n    \"id\": \"<string>\",\n    \"provider\": \"idwall\"\n  },\n  \"pep\": {\n    \"declared\": true,\n    \"full-name\": \"<string>\",\n    \"role\": \"<string>\"\n  },\n  \"financial-profile\": {\n    \"sector\": \"other\",\n    \"currency\": \"BRL\",\n    \"monthly-income\": 12000,\n    \"net-worth\": 850000,\n    \"source-of-funds\": []\n  },\n  \"email\": \"maria@example.com\",\n  \"phone\": \"+5511999999999\",\n  \"mother-full-name\": \"Ana Silva\",\n  \"external-wallets\": [\n    {\n      \"address\": \"0xabc...\",\n      \"capabilities\": [\n        \"fx\"\n      ],\n      \"custody-country\": \"BRA\",\n      \"custodian-name\": \"<string>\",\n      \"owner-type\": \"third-party\",\n      \"owner-name\": \"Acme Ltd\"\n    }\n  ]\n}"

response = http.request(request)
puts response.read_body

{
  "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"
  }
}

{
  "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"
  }
}

{
  "error": {
    "type": "<string>",
    "message": "<string>",
    "code": "<string>"
  }
}

{
  "error": {
    "type": "<string>",
    "message": "<string>",
    "code": "<string>"
  }
}

{
  "error": {
    "type": "<string>",
    "message": "<string>",
    "code": "<string>"
  }
}

{
  "error": {
    "type": "<string>",
    "message": "<string>",
    "code": "<string>"
  }
}

Body

application/json

identifiers

object[]

required

The numbers that identify the person, one entry per country. A Brazilian tax resident must list their CPF under BRA, and may also list identifiers from other countries. Every other residence must list an identifier from outside Brazil, and may add further identifiers, including an entry under BRA when the person also holds a CPF

Show child attributes

Example:

[
  { "value": "X1234567", "country": "PRT" },
  { "value": "07051368923", "country": "BRA" }
]

tax-residence

string

required

Tax residence country, ISO-3

Example:

"BRA"

reward-tier

enum<number>

required

CDI reward tier (%) for the account. The parent account must hold the matching subaccounts--tier capability.

Available options:

93.5,

90,

97

Example:

97

first-name

string

required

Account holder's given name

Example:

"Maria"

last-name

string

required

Account holder's family name

Example:

"Silva"

date-of-birth

string<date>

required

Must be the birth date of someone at least 18 years old

Example:

"1990-04-12"

address

object

required

Show child attributes

document

object

required

The holder's identity document. Referenced ids come from POST /v1/accounts/files

Show child attributes

liveness

object

required

Show child attributes

pep

object

required

Show child attributes

financial-profile

object

required

What the holder does, earns and owns. A declaration that informs compliance review

Show child attributes

string<email>

Example:

"maria@example.com"

phone

string

At most 32 characters

Example:

"+5511999999999"

mother-full-name

string

Example:

"Ana Silva"

representative

object

The person acting for the holder under a power of attorney. Sent only when the holder does not act for themselves

Show child attributes

external-wallets

object[]

The account's destination wallets, at most 5

Maximum array length: 5

Show child attributes

Response

An equivalent non-terminal request already exists

account

object

required

Show child attributes

API documentation

Accounts

Orders

Quotes

Wallets

Transfers

NFT transfers

Withdrawals

Deposits

Balance

Claims

Auto-claims

Tax exemption

Webhooks

Create Account (KYC, Individual)

Body

Response