Skip to main content
POST
Create a company account (kyc)

Body

application/json

A company whose tax residence is Brazil, and therefore identified by a CNPJ. The CNPJ answers for the company itself, so the body asks for its names and the people behind it and nothing else

identifiers
object[]
required

The numbers that identify the company, at most one entry per country and type. A company resident in Brazil must send its CNPJ under BRA, and may also send identifiers from other countries. A company resident abroad must send an identifier issued outside Brazil, by any country, as either the tax identification or the registration number, and may add further identifiers, including an entry under BRA when the company also holds a CNPJ

Example:
tax-residence
enum<string>
required

Tax residence country, ISO-3

Available options:
BRA
Example:

"BRA"

The name the company is registered under

Example:

"Acme Servicos Ltda"

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

The natural persons behind the company: its representatives, its directors and every ultimate beneficial owner above 25%. The ownership chain is flattened: this list never carries a company, only the people at the end of it

Minimum array length: 1
trade-name
string

The name the company trades under, when it differs from the registered one

Example:

"Acme"

external-wallets
object[]

The account's destination wallets, at most 5

Maximum array length: 5

Response

An equivalent non-terminal request already exists

account
object
required