Requests onboarding of a company account whose verification Crown runs itself.
The body carries the company profile plus the people behind it: every representative, director and ultimate beneficial owner, each with their identity document and, where their role asks for one, the liveness session and the power of attorney. Files travel as ids: upload each one with POST /v1/accounts/files, then reference the returned id here.
tax-residence selects the body. A company resident in BRA sends the Brazilian Company body; every other company sends the Foreign Company body.
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.
A company whose tax-residence is BRA must list its CNPJ under BRA, and may also list identifiers from other countries. A company resident abroad must list an identifier from outside Brazil, and may add further identifiers, including the CNPJ it holds under BRA.
An entry under BRA must be a valid CNPJ and carries no type. Every entry outside BRA carries a type.
headquarters-address.state is required when headquarters-address.country is BRA, where it must be the two-letter federal unit code (SP, RJ, MG, …).
For every entry in related-parties, identifier.country must be BRA exactly when that person’s tax-residence is BRA, and a BRA identifier must be a valid CPF. Each person’s identifier and residence are read on their own, not against the company’s.
For every entry in related-parties, date-of-birth, address and document follow the same rules as an individual holder’s.
At least one entry in related-parties holds the representative role.
liveness and power-of-attorney-file-id are required of every representative and rejected on anyone else. ownership-percentage and financial-profile are required of every ubo and rejected on anyone else.
The declared ownership-percentage values together cannot exceed 100.
The same person, by identifier, appears at most once in related-parties.
Every file id referenced in the body 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-typeaccount-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.
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
CDI reward tier (%) for the account. The parent account must hold the matching subaccounts--tier capability.
Available options:
93.5,
90,
97
Example:
97
related-parties
object[]
required
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
Show child attributes
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
Show child attributes
Response
An equivalent non-terminal request already exists
account
object
required
Show child attributes
{"docsConfig":{"theme":"mint","$schema":"https://mintlify.com/docs.json","name":"Crown API Documentation","colors":{"primary":"#002804","light":"#DAD7C8","dark":"#002804"},"logo":{"light":"https://mintcdn.com/crown-2b36dce9/-If___UpDLMLlFoP/logo/light.svg?fit=max\u0026auto=format\u0026n=-If___UpDLMLlFoP\u0026q=85\u0026s=ac83b7b6f874f0613ee2d0c9a5ade601","dark":"https://mintcdn.com/crown-2b36dce9/-If___UpDLMLlFoP/logo/dark.svg?fit=max\u0026auto=format\u0026n=-If___UpDLMLlFoP\u0026q=85\u0026s=6cf82e209d2e6bd90fa78c7a47b9404d"},"favicon":"https://mintcdn.com/crown-2b36dce9/-If___UpDLMLlFoP/favicon.svg?fit=max\u0026auto=format\u0026n=-If___UpDLMLlFoP\u0026q=85\u0026s=aa30534896387d541312323082b55ff5","background":{"color":{"light":"#DAD7C8","dark":"#002804"}},"navbar":{"links":[{"href":"https://status.crown-brlv.com","label":"Status"},{"href":"mailto:operations@crowndigital.xyz","label":"Support"}],"primary":{"type":"button","label":"Dashboard","href":"https://app.crown-brlv.com"}},"footer":{"socials":{"linkedin":"https://www.linkedin.com/company/crown-brl"}},"fonts":{"heading":{"family":"Season Mix","weight":700,"source":"fonts/SeasonMix-Bold.woff2","format":"woff2"},"body":{"family":"Season Sans","weight":400,"source":"fonts/SeasonSans-Regular.woff2","format":"woff2"}},"contextual":{"options":["copy","view","chatgpt","claude","perplexity","mcp","cursor","vscode"],"display":"header"},"styling":{"latex":false},"navigation":{"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"crown-2b36dce9","hasAudioNarration":false,"actualSubdomain":"crown-2b36dce9","customDomains":["docs.crown-brlv.com"],"gitSource":{"type":"github","owner":"crown-xyz","repo":"crown-api-docs","deployBranch":"main","contentDirectory":"","isPrivate":true,"mountPath":"","label":""},"entitlements":{},"buildId":"6b01ff9aac9e5178e345ae3f","clientVersion":"0.0.4270","searchFilterCounts":[{"language":"default","tag":"API reference","count":82},{"language":"default","tag":"Claims","count":13},{"language":"default","tag":"Auto-claims","count":11},{"language":"default","tag":"Guides","count":11},{"language":"default","tag":"Webhooks","count":10},{"language":"default","tag":"Withdrawals","count":9},{"language":"default","tag":"Orders","count":7},{"language":"default","tag":"Wallets","count":7},{"language":"default","tag":"Accounts","count":6},{"language":"default","tag":"Deposits","count":5}]},"assistantConfig":{},"basePath":"","hasChatPermissions":false,"hasWebMcpPermissions":false,"toggles":[{"name":"kill-isr","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-rbac-roles","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-mintlify-slack","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-integrations-settings","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"rbac-expansion","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-pr-grouping","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-prefix","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"analytics-v7","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"user-flows-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"no-publish-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-onboarding","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving-live","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"stripTemperatureMiddleware","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"support-platform-pylon-zendesk","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"instant-rollback","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications-server","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-fable","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fixed-ai-action-pricing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"site-roles","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automation-resolve-merge-conflict","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"scoped-publishing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"mintql","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"page-level-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-version-history-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"billing-page-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"full-page-search","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workspace-projects","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"assistant-v5","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fork-pr-previews","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"revalidation-jwt","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-sso-scim","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"hobby-abuse-scan","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"dashboard-inbox","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-signup","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-dual-write","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-enabled","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"approve-review-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-metadata","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"sso-setup-deadline-banner","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-serve","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"live-agents","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"starter-pricing","enabled":true,"variant":{"name":"control","enabled":true,"payload":{"type":"string","value":"control"},"feature_enabled":true},"impressionData":false},{"name":"llms-txt-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"wildcard-email-auth","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false}],"googleFontsInlined":false},"customCss":[{"filePath":"style.css","content":".crown-deprecated{--cd-oxblood: #b5454a;--cd-cream: #dad7c8;display:flex;align-items:center;gap:1rem 1.5rem;flex-wrap:wrap;margin:0 0 2rem;padding:0.875rem 1.25rem;border:1px solid color-mix(in srgb, var(--cd-oxblood) 28%, transparent);border-radius:0.75rem;background:color-mix(in srgb, var(--cd-oxblood) 10%, transparent);font-family:\"Season Sans\", ui-sans-serif, system-ui, sans-serif;animation:cd-rise 0.45s cubic-bezier(0.22, 1, 0.36, 1) both}@keyframes cd-rise{from{opacity:0;transform:translateY(5px)}to{opacity:1;transform:translateY(0)}}.crown-deprecated__dot{flex:none;width:0.5rem;height:0.5rem;border-radius:50%;background:var(--cd-oxblood);box-shadow:0 0 0 4px color-mix(in srgb, var(--cd-oxblood) 18%, transparent)}.crown-deprecated__text{flex:1 1 16rem;margin:0;font-size:0.9375rem;line-height:1.45;color:color-mix(in srgb, #7a2e32 92%, black)}.crown-deprecated__text strong{font-weight:700;color:#7a2e32}.crown-deprecated__action{flex:none;display:inline-flex;align-items:center;gap:0.4rem;font-size:0.875rem;font-weight:600;white-space:nowrap;text-decoration:none;color:#7a2e32;transition:gap 0.18s ease, opacity 0.18s ease}.crown-deprecated__action:hover{gap:0.6rem;opacity:0.85}.dark .crown-deprecated{border-color:color-mix(in srgb, var(--cd-oxblood) 40%, transparent);background:color-mix(in srgb, var(--cd-oxblood) 16%, transparent)}.dark .crown-deprecated__text{color:color-mix(in srgb, var(--cd-cream) 88%, transparent)}.dark .crown-deprecated__text strong{color:var(--cd-cream)}.dark .crown-deprecated__dot{background:#e8868a;box-shadow:0 0 0 4px color-mix(in srgb, #e8868a 20%, transparent)}.dark .crown-deprecated__action{color:var(--cd-cream)}@media (prefers-reduced-motion: reduce){.crown-deprecated{animation:none}.crown-deprecated__action{transition:none}}:root{--cv-forest: #002804;--cv-cream: #dad7c8}div:has(>[data-component-part=\"version-select-trigger\"])::before{content:\"VERSION\";align-self:center;font-family:\"Season Sans\", ui-sans-serif, system-ui, sans-serif;font-size:0.6875rem;font-weight:600;letter-spacing:0.14em;color:color-mix(in srgb, var(--cv-forest) 48%, transparent)}[data-component-part=\"version-select-trigger\"]{border:1px solid color-mix(in srgb, var(--cv-forest) 22%, transparent);background:color-mix(in srgb, var(--cv-forest) 5%, transparent);border-radius:0.75rem;padding-top:0.375rem;padding-bottom:0.375rem;transition:border-color 0.18s ease, background 0.18s ease}[data-component-part=\"version-select-trigger\"]:hover{border-color:color-mix(in srgb, var(--cv-forest) 36%, transparent)}[data-component-part=\"version-select-trigger\"]>span{font-family:\"Season Mix\", Georgia, serif;font-weight:700;font-variant-numeric:tabular-nums}.dark div:has(>[data-component-part=\"version-select-trigger\"])::before{color:color-mix(in srgb, var(--cv-cream) 52%, transparent)}.dark [data-component-part=\"version-select-trigger\"]{border-color:color-mix(in srgb, var(--cv-cream) 22%, transparent);background:color-mix(in srgb, var(--cv-cream) 5%, transparent)}.dark [data-component-part=\"version-select-trigger\"]:hover{border-color:color-mix(in srgb, var(--cv-cream) 38%, transparent)}[data-component-part=\"version-select-item\"]>p{flex:0 0 auto}[data-component-part=\"version-select-item\"]>svg{margin-left:auto}"}]}
{"page":{"pagePath":"api-reference/endpoint/v1/accounts/create-kyc-company-account","slug":"/api-reference/endpoint/v1/accounts/create-kyc-company-account","pageMetadata":{"title":"Create Account (KYC, Company)","openapi":"POST /api/v1/accounts/kyc/company","description":"Requests onboarding of a company account whose verification Crown runs itself.\n\nThe body carries the company profile plus the people behind it: every representative, director and ultimate beneficial owner, each with their identity document and, where their role asks for one, the liveness session and the power of attorney. Files travel as ids: upload each one with `POST /v1/accounts/files`, then reference the returned id here.\n\n`tax-residence` selects the body. A company resident in `BRA` sends the Brazilian Company body; every other company sends the Foreign Company body.\n\nRequest-first: the response describes a creation request, not an account. The request enters compliance review and the account is provisioned on approval.\n\nEvery country code in the body is ISO 3166-1 alpha-3, read regardless of case: `bra` is read as `BRA`.\n\n**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:\n\n- 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`.\n- The parent must hold the `subaccounts-\u003ctier>-tier` capability matching `reward-tier`, or the request is refused with `403`.\n- `identifiers` carries at most one entry per country.\n- A company whose `tax-residence` is `BRA` must list its CNPJ under `BRA`, and may also list identifiers from other countries. A company resident abroad must list an identifier from outside Brazil, and may add further identifiers, including the CNPJ it holds under `BRA`.\n- An entry under `BRA` must be a valid CNPJ and carries no `type`. Every entry outside `BRA` carries a `type`.\n- `headquarters-address.state` is required when `headquarters-address.country` is `BRA`, where it must be the two-letter federal unit code (`SP`, `RJ`, `MG`, …).\n- For every entry in `related-parties`, `identifier.country` must be `BRA` exactly when that person's `tax-residence` is `BRA`, and a BRA identifier must be a valid CPF. Each person's identifier and residence are read on their own, not against the company's.\n- For every entry in `related-parties`, `date-of-birth`, `address` and `document` follow the same rules as an individual holder's.\n- At least one entry in `related-parties` holds the `representative` role.\n- `liveness` and `power-of-attorney-file-id` are required of every representative and rejected on anyone else. `ownership-percentage` and `financial-profile` are required of every ubo and rejected on anyone else.\n- The declared `ownership-percentage` values together cannot exceed 100.\n- The same person, by `identifier`, appears at most once in `related-parties`.\n- Every file id referenced in the body must have been uploaded by this same parent account via `POST /v1/accounts/files`.\n- `external-wallets` holds at most 5 wallets, and their addresses must be unique within the request.\n- 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.\n- Any other wallet accepts `owner-type` `account-holder` only, and no `owner-name`.\n- 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.\n\n**Idempotency**: sending the same holder again while its request is `pending` returns that request with `200`, instead of creating a second one.","href":"/api-reference/endpoint/v1/accounts/create-kyc-company-account"},"description":{"compiledSource":"\"use strict\";\nconst {Fragment: _Fragment, jsx: _jsx, jsxs: _jsxs} = arguments[0];\nconst {useMDXComponents: _provideComponents} = arguments[0];\nfunction _createMdxContent(props) {\n const _components = {\n code: \"code\",\n li: \"li\",\n p: \"p\",\n strong: \"strong\",\n ul: \"ul\",\n ..._provideComponents(),\n ...props.components\n };\n return _jsxs(_Fragment, {\n children: [_jsx(_components.p, {\n children: \"Requests onboarding of a company account whose verification Crown runs itself.\"\n }), \"\\n\", _jsxs(_components.p, {\n children: [\"The body carries the company profile plus the people behind it: every representative, director and ultimate beneficial owner, each with their identity document and, where their role asks for one, the liveness session and the power of attorney. Files travel as ids: upload each one with \", _jsx(_components.code, {\n children: \"POST /v1/accounts/files\"\n }), \", then reference the returned id here.\"]\n }), \"\\n\", _jsxs(_components.p, {\n children: [_jsx(_components.code, {\n children: \"tax-residence\"\n }), \" selects the body. A company resident in \", _jsx(_components.code, {\n children: \"BRA\"\n }), \" sends the Brazilian Company body; every other company sends the Foreign Company body.\"]\n }), \"\\n\", _jsx(_components.p, {\n children: \"Request-first: the response describes a creation request, not an account. The request enters compliance review and the account is provisioned on approval.\"\n }), \"\\n\", _jsxs(_components.p, {\n children: [\"Every country code in the body is ISO 3166-1 alpha-3, read regardless of case: \", _jsx(_components.code, {\n children: \"bra\"\n }), \" is read as \", _jsx(_components.code, {\n children: \"BRA\"\n }), \".\"]\n }), \"\\n\", _jsxs(_components.p, {\n children: [_jsx(_components.strong, {\n children: \"Validated on this request\"\n }), \" — every rule below is answered before anything is created, so no valid body needs a round trip to discover a condition:\"]\n }), \"\\n\", _jsxs(_components.ul, {\n children: [\"\\n\", _jsxs(_components.li, {\n children: [\"The parent account must onboard accounts in kyc mode. A parent that onboards in reliance mode is refused with \", _jsx(_components.code, {\n children: \"403\"\n }), \" and must use \", _jsx(_components.code, {\n children: \"POST /v1/accounts/reliance\"\n }), \".\"]\n }), \"\\n\", _jsxs(_components.li, {\n children: [\"The parent must hold the \", _jsx(_components.code, {\n children: \"subaccounts-\u003ctier>-tier\"\n }), \" capability matching \", _jsx(_components.code, {\n children: \"reward-tier\"\n }), \", or the request is refused with \", _jsx(_components.code, {\n children: \"403\"\n }), \".\"]\n }), \"\\n\", _jsxs(_components.li, {\n children: [_jsx(_components.code, {\n children: \"identifiers\"\n }), \" carries at most one entry per country.\"]\n }), \"\\n\", _jsxs(_components.li, {\n children: [\"A company whose \", _jsx(_components.code, {\n children: \"tax-residence\"\n }), \" is \", _jsx(_components.code, {\n children: \"BRA\"\n }), \" must list its CNPJ under \", _jsx(_components.code, {\n children: \"BRA\"\n }), \", and may also list identifiers from other countries. A company resident abroad must list an identifier from outside Brazil, and may add further identifiers, including the CNPJ it holds under \", _jsx(_components.code, {\n children: \"BRA\"\n }), \".\"]\n }), \"\\n\", _jsxs(_components.li, {\n children: [\"An entry under \", _jsx(_components.code, {\n children: \"BRA\"\n }), \" must be a valid CNPJ and carries no \", _jsx(_components.code, {\n children: \"type\"\n }), \". Every entry outside \", _jsx(_components.code, {\n children: \"BRA\"\n }), \" carries a \", _jsx(_components.code, {\n children: \"type\"\n }), \".\"]\n }), \"\\n\", _jsxs(_components.li, {\n children: [_jsx(_components.code, {\n children: \"headquarters-address.state\"\n }), \" is required when \", _jsx(_components.code, {\n children: \"headquarters-address.country\"\n }), \" is \", _jsx(_components.code, {\n children: \"BRA\"\n }), \", where it must be the two-letter federal unit code (\", _jsx(_components.code, {\n children: \"SP\"\n }), \", \", _jsx(_components.code, {\n children: \"RJ\"\n }), \", \", _jsx(_components.code, {\n children: \"MG\"\n }), \", …).\"]\n }), \"\\n\", _jsxs(_components.li, {\n children: [\"For every entry in \", _jsx(_components.code, {\n children: \"related-parties\"\n }), \", \", _jsx(_components.code, {\n children: \"identifier.country\"\n }), \" must be \", _jsx(_components.code, {\n children: \"BRA\"\n }), \" exactly when that person’s \", _jsx(_components.code, {\n children: \"tax-residence\"\n }), \" is \", _jsx(_components.code, {\n children: \"BRA\"\n }), \", and a BRA identifier must be a valid CPF. Each person’s identifier and residence are read on their own, not against the company’s.\"]\n }), \"\\n\", _jsxs(_components.li, {\n children: [\"For every entry in \", _jsx(_components.code, {\n children: \"related-parties\"\n }), \", \", _jsx(_components.code, {\n children: \"date-of-birth\"\n }), \", \", _jsx(_components.code, {\n children: \"address\"\n }), \" and \", _jsx(_components.code, {\n children: \"document\"\n }), \" follow the same rules as an individual holder’s.\"]\n }), \"\\n\", _jsxs(_components.li, {\n children: [\"At least one entry in \", _jsx(_components.code, {\n children: \"related-parties\"\n }), \" holds the \", _jsx(_components.code, {\n children: \"representative\"\n }), \" role.\"]\n }), \"\\n\", _jsxs(_components.li, {\n children: [_jsx(_components.code, {\n children: \"liveness\"\n }), \" and \", _jsx(_components.code, {\n children: \"power-of-attorney-file-id\"\n }), \" are required of every representative and rejected on anyone else. \", _jsx(_components.code, {\n children: \"ownership-percentage\"\n }), \" and \", _jsx(_components.code, {\n children: \"financial-profile\"\n }), \" are required of every ubo and rejected on anyone else.\"]\n }), \"\\n\", _jsxs(_components.li, {\n children: [\"The declared \", _jsx(_components.code, {\n children: \"ownership-percentage\"\n }), \" values together cannot exceed 100.\"]\n }), \"\\n\", _jsxs(_components.li, {\n children: [\"The same person, by \", _jsx(_components.code, {\n children: \"identifier\"\n }), \", appears at most once in \", _jsx(_components.code, {\n children: \"related-parties\"\n }), \".\"]\n }), \"\\n\", _jsxs(_components.li, {\n children: [\"Every file id referenced in the body must have been uploaded by this same parent account via \", _jsx(_components.code, {\n children: \"POST /v1/accounts/files\"\n }), \".\"]\n }), \"\\n\", _jsxs(_components.li, {\n children: [_jsx(_components.code, {\n children: \"external-wallets\"\n }), \" holds at most 5 wallets, and their addresses must be unique within the request.\"]\n }), \"\\n\", _jsxs(_components.li, {\n children: [\"A wallet whose \", _jsx(_components.code, {\n children: \"capabilities\"\n }), \" is \", _jsx(_components.code, {\n children: \"fx\"\n }), \" alone needs \", _jsx(_components.code, {\n children: \"custody-type\"\n }), \", \", _jsx(_components.code, {\n children: \"custody-country\"\n }), \" (ISO-3) and \", _jsx(_components.code, {\n children: \"owner-type\"\n }), \". It needs \", _jsx(_components.code, {\n children: \"custodian-name\"\n }), \" with \", _jsx(_components.code, {\n children: \"exchange\"\n }), \" custody and refuses it with \", _jsx(_components.code, {\n children: \"self\"\n }), \", and needs \", _jsx(_components.code, {\n children: \"owner-name\"\n }), \" with a \", _jsx(_components.code, {\n children: \"third-party\"\n }), \" owner and refuses it otherwise.\"]\n }), \"\\n\", _jsxs(_components.li, {\n children: [\"Any other wallet accepts \", _jsx(_components.code, {\n children: \"owner-type\"\n }), \" \", _jsx(_components.code, {\n children: \"account-holder\"\n }), \" only, and no \", _jsx(_components.code, {\n children: \"owner-name\"\n }), \".\"]\n }), \"\\n\", _jsxs(_components.li, {\n children: [\"No address may already be another account’s external wallet. A wallet with \", _jsx(_components.code, {\n children: \"fx\"\n }), \" alone may be one other accounts already receive FX payouts in; any other wallet may not.\"]\n }), \"\\n\"]\n }), \"\\n\", _jsxs(_components.p, {\n children: [_jsx(_components.strong, {\n children: \"Idempotency\"\n }), \": sending the same holder again while its request is \", _jsx(_components.code, {\n children: \"pending\"\n }), \" returns that request with \", _jsx(_components.code, {\n children: \"200\"\n }), \", instead of creating a second one.\"]\n })]\n });\n}\nfunction MDXContent(props = {}) {\n const {wrapper: MDXLayout} = {\n ..._provideComponents(),\n ...props.components\n };\n return MDXLayout ? _jsx(MDXLayout, {\n ...props,\n children: _jsx(_createMdxContent, {\n ...props\n })\n }) : _createMdxContent(props);\n}\nreturn {\n default: MDXContent\n};\n","frontmatter":{},"scope":{}},"pageType":"default","mdx":{"mdxSource":{"compiledSource":"\"use strict\";const{Fragment:_Fragment,jsx:_jsx}=arguments[0];const{useMDXComponents:_provideComponents}=arguments[0];function _createMdxContent(props){return _jsx(_Fragment,{})}function MDXContent(props={}){const{wrapper:MDXLayout}={..._provideComponents(),...props.components};return MDXLayout?_jsx(MDXLayout,{...props,children:_jsx(_createMdxContent,{...props})}):_createMdxContent(props)}return{default:MDXContent}","frontmatter":{},"scope":{"config":{},"pageMetadata":{"title":"Create Account (KYC, Company)","openapi":"POST /api/v1/accounts/kyc/company","description":"Requests onboarding of a company account whose verification Crown runs itself.\n\nThe body carries the company profile plus the people behind it: every representative, director and ultimate beneficial owner, each with their identity document and, where their role asks for one, the liveness session and the power of attorney. Files travel as ids: upload each one with `POST /v1/accounts/files`, then reference the returned id here.\n\n`tax-residence` selects the body. A company resident in `BRA` sends the Brazilian Company body; every other company sends the Foreign Company body.\n\nRequest-first: the response describes a creation request, not an account. The request enters compliance review and the account is provisioned on approval.\n\nEvery country code in the body is ISO 3166-1 alpha-3, read regardless of case: `bra` is read as `BRA`.\n\n**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:\n\n- 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`.\n- The parent must hold the `subaccounts-\u003ctier>-tier` capability matching `reward-tier`, or the request is refused with `403`.\n- `identifiers` carries at most one entry per country.\n- A company whose `tax-residence` is `BRA` must list its CNPJ under `BRA`, and may also list identifiers from other countries. A company resident abroad must list an identifier from outside Brazil, and may add further identifiers, including the CNPJ it holds under `BRA`.\n- An entry under `BRA` must be a valid CNPJ and carries no `type`. Every entry outside `BRA` carries a `type`.\n- `headquarters-address.state` is required when `headquarters-address.country` is `BRA`, where it must be the two-letter federal unit code (`SP`, `RJ`, `MG`, …).\n- For every entry in `related-parties`, `identifier.country` must be `BRA` exactly when that person's `tax-residence` is `BRA`, and a BRA identifier must be a valid CPF. Each person's identifier and residence are read on their own, not against the company's.\n- For every entry in `related-parties`, `date-of-birth`, `address` and `document` follow the same rules as an individual holder's.\n- At least one entry in `related-parties` holds the `representative` role.\n- `liveness` and `power-of-attorney-file-id` are required of every representative and rejected on anyone else. `ownership-percentage` and `financial-profile` are required of every ubo and rejected on anyone else.\n- The declared `ownership-percentage` values together cannot exceed 100.\n- The same person, by `identifier`, appears at most once in `related-parties`.\n- Every file id referenced in the body must have been uploaded by this same parent account via `POST /v1/accounts/files`.\n- `external-wallets` holds at most 5 wallets, and their addresses must be unique within the request.\n- 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.\n- Any other wallet accepts `owner-type` `account-holder` only, and no `owner-name`.\n- 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.\n\n**Idempotency**: sending the same holder again while its request is `pending` returns that request with `200`, instead of creating a second one.","href":"/api-reference/endpoint/v1/accounts/create-kyc-company-account"}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[],"codeExamples":{}},"jsLinks":[],"openApiReferenceData":{"operation":{"summary":"Create a company account (kyc)","description":"Requests onboarding of a company account whose verification Crown runs itself.\n\nThe body carries the company profile plus the people behind it: every representative, director and ultimate beneficial owner, each with their identity document and, where their role asks for one, the liveness session and the power of attorney. Files travel as ids: upload each one with `POST /v1/accounts/files`, then reference the returned id here.\n\n`tax-residence` selects the body. A company resident in `BRA` sends the Brazilian Company body; every other company sends the Foreign Company body.\n\nRequest-first: the response describes a creation request, not an account. The request enters compliance review and the account is provisioned on approval.\n\nEvery country code in the body is ISO 3166-1 alpha-3, read regardless of case: `bra` is read as `BRA`.\n\n**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:\n\n- 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`.\n- The parent must hold the `subaccounts-\u003ctier>-tier` capability matching `reward-tier`, or the request is refused with `403`.\n- `identifiers` carries at most one entry per country.\n- A company whose `tax-residence` is `BRA` must list its CNPJ under `BRA`, and may also list identifiers from other countries. A company resident abroad must list an identifier from outside Brazil, and may add further identifiers, including the CNPJ it holds under `BRA`.\n- An entry under `BRA` must be a valid CNPJ and carries no `type`. Every entry outside `BRA` carries a `type`.\n- `headquarters-address.state` is required when `headquarters-address.country` is `BRA`, where it must be the two-letter federal unit code (`SP`, `RJ`, `MG`, …).\n- For every entry in `related-parties`, `identifier.country` must be `BRA` exactly when that person's `tax-residence` is `BRA`, and a BRA identifier must be a valid CPF. Each person's identifier and residence are read on their own, not against the company's.\n- For every entry in `related-parties`, `date-of-birth`, `address` and `document` follow the same rules as an individual holder's.\n- At least one entry in `related-parties` holds the `representative` role.\n- `liveness` and `power-of-attorney-file-id` are required of every representative and rejected on anyone else. `ownership-percentage` and `financial-profile` are required of every ubo and rejected on anyone else.\n- The declared `ownership-percentage` values together cannot exceed 100.\n- The same person, by `identifier`, appears at most once in `related-parties`.\n- Every file id referenced in the body must have been uploaded by this same parent account via `POST /v1/accounts/files`.\n- `external-wallets` holds at most 5 wallets, and their addresses must be unique within the request.\n- 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.\n- Any other wallet accepts `owner-type` `account-holder` only, and no `owner-name`.\n- 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.\n\n**Idempotency**: sending the same holder again while its request is `pending` returns that request with `200`, instead of creating a second one.","requestBody":"2514dcb6-9f03-4307-a485-d5c5f495ba55","responses":{"200":"8b2594fd-71a1-4127-b24b-01ebba8103ae","201":"ead1dba8-b099-42a6-b8a5-b5cf2c4ee2be","400":"9fb15195-2548-4438-b809-8257a78130bb","403":"a8dd312c-2daf-47f2-9598-74cdc4df3788","404":"d4ed30d3-1dbd-4029-a1f7-a826d98194a4","422":"0ad10000-b100-41e3-89f2-93b5e7d0923f"},"method":"post","type":"path","servers":["ee89d649-0f73-4d69-b1b2-e951fc9f7e0e"],"security":[],"path":"/api/v1/accounts/kyc/company","baseUrlOptions":["https://app.crown-brlv.com"],"title":"Create a company account (kyc)","codeSamples":[],"requiredOnlyExamples":false,"requestExampleType":"generated","responseExampleType":"generated"},"dependencies":{"parameters":{},"requestBody":{"content":{"application/json":{"schema":{"oneOf":[{"type":"object","title":"Brazilian Company","description":"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","required":["identifiers","tax-residence","legal-name","reward-tier","related-parties"],"properties":{"identifiers":{"type":"array","description":"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","items":{"type":"object","properties":{"value":{"type":"string","description":"The number the register issued the company: a CNPJ when country is BRA","example":"98-7654321","isRequired":true,"uniqueKey":"oneOf.0.identifiers.items.[INDEX].value","typeLabel":"string"},"country":{"type":"string","description":"Country whose register issued the number, ISO-3","example":"CYM","isRequired":true,"uniqueKey":"oneOf.0.identifiers.items.[INDEX].country","typeLabel":"string"},"type":{"type":"string","enum":["tax-id","registration-number"],"description":"Which of the two numbers a foreign register issues this is: the country's tax identification, or the number the company is registered by at the registrar. Required outside BRA and not accepted under it, where the CNPJ is the only number the register issues","example":"registration-number","uniqueKey":"oneOf.0.identifiers.items.[INDEX].type","typeLabel":"enum\u003cstring>"}},"additionalProperties":false,"required":["value","country"],"uniqueKey":"oneOf.0.identifiers.items.[INDEX]","typeLabel":"object"},"example":[{"value":"12345678000195","country":"BRA"}],"isRequired":true,"uniqueKey":"oneOf.0.identifiers","typeLabel":"object[]"},"tax-residence":{"type":"string","enum":["BRA"],"description":"Tax residence country, ISO-3","example":"BRA","isRequired":true,"uniqueKey":"oneOf.0.tax-residence","typeLabel":"enum\u003cstring>"},"legal-name":{"type":"string","description":"The name the company is registered under","example":"Acme Servicos Ltda","isRequired":true,"uniqueKey":"oneOf.0.legal-name","typeLabel":"string"},"reward-tier":{"type":"number","format":"double","enum":[93.5,90,97],"description":"CDI reward tier (%) for the account. The parent account must hold the matching subaccounts-\u003ctier>-tier capability.","example":97,"isRequired":true,"uniqueKey":"oneOf.0.reward-tier","typeLabel":"enum\u003cnumber>"},"related-parties":{"type":"array","minItems":1,"items":{"type":"object","properties":{"first-name":{"type":"string","description":"The person's given name, as their identity document spells it","example":"Ana","isRequired":true,"uniqueKey":"oneOf.0.related-parties.items.[INDEX].first-name","typeLabel":"string"},"last-name":{"type":"string","description":"The person's family name, as their identity document spells it","example":"Silva","isRequired":true,"uniqueKey":"oneOf.0.related-parties.items.[INDEX].last-name","typeLabel":"string"},"date-of-birth":{"type":"string","format":"date","description":"Must be the birth date of someone at least 18 years old","example":"1990-04-12","isRequired":true,"uniqueKey":"oneOf.0.related-parties.items.[INDEX].date-of-birth","typeLabel":"string\u003cdate>"},"identifier":{"type":"object","properties":{"value":{"type":"string","description":"The number that identifies the person: a CPF when country is BRA, the passport number otherwise","example":"12345678909","isRequired":true,"uniqueKey":"oneOf.0.related-parties.items.[INDEX].identifier.value","typeLabel":"string"},"country":{"type":"string","description":"Country that issued the number, ISO-3. BRA means the number is a CPF; every other country means it is the passport that country issued","example":"BRA","isRequired":true,"uniqueKey":"oneOf.0.related-parties.items.[INDEX].identifier.country","typeLabel":"string"}},"additionalProperties":false,"required":["value","country"],"description":"How the person is identified. A Brazilian tax resident is identified by CPF, every other residence by passport","isRequired":true,"uniqueKey":"oneOf.0.related-parties.items.[INDEX].identifier","typeLabel":"object"},"tax-residence":{"type":"string","description":"The person's own tax residence, ISO-3. It is read on its own, not against the company's","example":"BRA","isRequired":true,"uniqueKey":"oneOf.0.related-parties.items.[INDEX].tax-residence","typeLabel":"string"},"address":{"type":"object","properties":{"postal-code":{"type":"string","example":"01310-100","isRequired":true,"uniqueKey":"oneOf.0.related-parties.items.[INDEX].address.postal-code","typeLabel":"string"},"line1":{"type":"string","example":"Avenida Paulista, 1000","isRequired":true,"uniqueKey":"oneOf.0.related-parties.items.[INDEX].address.line1","typeLabel":"string"},"city":{"type":"string","example":"Sao Paulo","isRequired":true,"uniqueKey":"oneOf.0.related-parties.items.[INDEX].address.city","typeLabel":"string"},"country":{"type":"string","description":"ISO 3166-1 alpha-3 country code","example":"BRA","isRequired":true,"uniqueKey":"oneOf.0.related-parties.items.[INDEX].address.country","typeLabel":"string"},"line2":{"type":"string","description":"Empty when there is nothing to add to line1","uniqueKey":"oneOf.0.related-parties.items.[INDEX].address.line2","typeLabel":"string"},"state":{"type":"string","description":"Required when country is BRA, where it must be the two-letter federal unit code","example":"SP","uniqueKey":"oneOf.0.related-parties.items.[INDEX].address.state","typeLabel":"string"}},"additionalProperties":false,"required":["postal-code","line1","city","country"],"description":"Where the person lives. state is required when country is BRA, where it must be the two-letter federal unit code","isRequired":true,"uniqueKey":"oneOf.0.related-parties.items.[INDEX].address","typeLabel":"object"},"document":{"type":"object","properties":{"front-file-id":{"type":"string","pattern":"^ev_[A-Z0-9]+$","description":"Front of the document, or the whole document in one file: an image, or a PDF of one or two pages","example":"ev_019712CFC86D703F85B8BDAA4FC8D254","isRequired":true,"uniqueKey":"oneOf.0.related-parties.items.[INDEX].document.front-file-id","typeLabel":"string"},"type":{"type":"string","enum":["rg","cnh","passport"],"description":"The person's identity document. Optional for a Brazilian tax resident, since the type is read from the image; every other residence sends passport","uniqueKey":"oneOf.0.related-parties.items.[INDEX].document.type","typeLabel":"enum\u003cstring>"},"back-file-id":{"type":"string","pattern":"^ev_[A-Z0-9]+$","description":"Back of the document, when it comes as a separate file. Not accepted for a passport, which is read from one page","example":"ev_019712CFC86D703F85B8BDAA4FC8D254","uniqueKey":"oneOf.0.related-parties.items.[INDEX].document.back-file-id","typeLabel":"string"}},"additionalProperties":false,"required":["front-file-id"],"description":"The person's identity document. Referenced ids come from POST /v1/accounts/files","isRequired":true,"uniqueKey":"oneOf.0.related-parties.items.[INDEX].document","typeLabel":"object"},"pep":{"type":"object","properties":{"declared":{"type":"boolean","description":"Whether the person is a politically exposed person, or related to one. When true the three detail fields below are all required","isRequired":true,"uniqueKey":"oneOf.0.related-parties.items.[INDEX].pep.declared","typeLabel":"boolean"},"full-name":{"type":"string","description":"Full name of the exposed person","uniqueKey":"oneOf.0.related-parties.items.[INDEX].pep.full-name","typeLabel":"string"},"role":{"type":"string","description":"Public role held","uniqueKey":"oneOf.0.related-parties.items.[INDEX].pep.role","typeLabel":"string"},"relationship":{"type":"string","enum":["self","spouse","child","parent","business_associate","other"],"description":"The holder's relationship to the exposed person","uniqueKey":"oneOf.0.related-parties.items.[INDEX].pep.relationship","typeLabel":"enum\u003cstring>"}},"additionalProperties":false,"required":["declared"],"isRequired":true,"uniqueKey":"oneOf.0.related-parties.items.[INDEX].pep","typeLabel":"object"},"roles":{"type":"array","minItems":1,"items":{"type":"string","enum":["representative","director","ubo"],"uniqueKey":"oneOf.0.related-parties.items.[INDEX].roles.items.[INDEX]","typeLabel":"enum\u003cstring>"},"description":"Every role the person holds in the company. One person is one entry, carrying the fields each of their roles asks for:\n\n| Value | Description |\n|---|---|\n| `representative` | Acts for the company. Sends `liveness` and `power-of-attorney-file-id` |\n| `director` | Sits on the company's management |\n| `ubo` | Ultimately owns more than 25% of the company. Sends `ownership-percentage` and `financial-profile` |","example":["representative","ubo"],"isRequired":true,"uniqueKey":"oneOf.0.related-parties.items.[INDEX].roles","typeLabel":"enum\u003cstring>[]"},"liveness":{"type":"object","properties":{"id":{"type":"string","description":"The session's id at the provider","isRequired":true,"uniqueKey":"oneOf.0.related-parties.items.[INDEX].liveness.id","typeLabel":"string"},"provider":{"type":"string","enum":["unico","sumsub","idwall","persona","idenfy"],"description":"Liveness provider that ran the session","example":"idwall","isRequired":true,"uniqueKey":"oneOf.0.related-parties.items.[INDEX].liveness.provider","typeLabel":"enum\u003cstring>"}},"additionalProperties":false,"required":["id","provider"],"description":"The liveness session the partner ran on the person. Required of a representative, and accepted of no one else","uniqueKey":"oneOf.0.related-parties.items.[INDEX].liveness","typeLabel":"object"},"power-of-attorney-file-id":{"type":"string","pattern":"^ev_[A-Z0-9]+$","description":"The instrument appointing the person to act for the company. Required of a representative, and accepted of no one else. Referenced by the id returned from POST /v1/accounts/files","example":"ev_019712CFC86D703F85B8BDAA4FC8D254","uniqueKey":"oneOf.0.related-parties.items.[INDEX].power-of-attorney-file-id","typeLabel":"string"},"ownership-percentage":{"type":"number","format":"double","exclusiveMinimum":0,"maximum":100,"description":"How much of the company the person ultimately owns. Required of a ubo, and accepted of no one else","example":35,"uniqueKey":"oneOf.0.related-parties.items.[INDEX].ownership-percentage","typeLabel":"number\u003cdouble>"},"financial-profile":{"type":"object","description":"What the person owns, net of debt. Required of a ubo, and accepted of no one else","properties":{"currency":{"type":"string","enum":["BRL","USD"],"description":"The one currency every amount below is declared in","example":"BRL","isRequired":true,"uniqueKey":"oneOf.0.related-parties.items.[INDEX].financial-profile.currency","typeLabel":"enum\u003cstring>"},"net-worth":{"type":"number","format":"double","description":"Everything the person owns, net of debt","example":850000,"isRequired":true,"uniqueKey":"oneOf.0.related-parties.items.[INDEX].financial-profile.net-worth","typeLabel":"number\u003cdouble>"}},"additionalProperties":false,"required":["currency","net-worth"],"uniqueKey":"oneOf.0.related-parties.items.[INDEX].financial-profile","typeLabel":"object"}},"additionalProperties":false,"required":["first-name","last-name","date-of-birth","identifier","tax-residence","address","document","pep","roles"],"uniqueKey":"oneOf.0.related-parties.items.[INDEX]","typeLabel":"object"},"description":"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","isRequired":true,"uniqueKey":"oneOf.0.related-parties","typeLabel":"object[]"},"trade-name":{"type":"string","description":"The name the company trades under, when it differs from the registered one","example":"Acme","uniqueKey":"oneOf.0.trade-name","typeLabel":"string"},"external-wallets":{"type":"array","description":"The account's destination wallets, at most 5","maxItems":5,"items":{"type":"object","properties":{"address":{"type":"string","description":"On-chain destination address","example":"0xabc...","isRequired":true,"uniqueKey":"oneOf.0.external-wallets.items.[INDEX].address","typeLabel":"string"},"capabilities":{"type":"array","items":{"type":"string","enum":["fx","rewards"],"uniqueKey":"oneOf.0.external-wallets.items.[INDEX].capabilities.items.[INDEX]","typeLabel":"enum\u003cstring>"},"minItems":1,"uniqueItems":true,"description":"What the wallet is for. A wallet with `rewards` earns the account's rewards, receives FX payouts too, and belongs to that account alone. A wallet with `fx` alone only receives FX payouts, and several accounts can declare the same one. Omitted, the wallet does both","example":["fx"],"uniqueKey":"oneOf.0.external-wallets.items.[INDEX].capabilities","typeLabel":"enum\u003cstring>[]"},"custody-country":{"oneOf":[{"type":"string","description":"Custodian country, ISO-3. Required when `capabilities` is `fx` alone","example":"BRA","uniqueKey":"oneOf.0.external-wallets.items.[INDEX].custody-country.oneOf.0","typeLabel":"string"},{"type":"null","description":"Custodian country, ISO-3. Required when `capabilities` is `fx` alone","example":"BRA","uniqueKey":"oneOf.0.external-wallets.items.[INDEX].custody-country.oneOf.1","typeLabel":"null"}],"uniqueKey":"oneOf.0.external-wallets.items.[INDEX].custody-country","typeLabel":"string | null"},"custody-type":{"oneOf":[{"type":"string","description":"Self-custody or exchange custody. Required when `capabilities` is `fx` alone","enum":["self","exchange"],"uniqueKey":"oneOf.0.external-wallets.items.[INDEX].custody-type.oneOf.0","typeLabel":"enum\u003cstring>"},{"type":"null","description":"Self-custody or exchange custody. Required when `capabilities` is `fx` alone","uniqueKey":"oneOf.0.external-wallets.items.[INDEX].custody-type.oneOf.1","typeLabel":"null"}],"uniqueKey":"oneOf.0.external-wallets.items.[INDEX].custody-type","typeLabel":"enum\u003cstring> | null"},"custodian-name":{"oneOf":[{"type":"string","description":"Custodian/exchange name. Required with `exchange` custody when `capabilities` is `fx` alone, and not accepted with `self` custody there","uniqueKey":"oneOf.0.external-wallets.items.[INDEX].custodian-name.oneOf.0","typeLabel":"string"},{"type":"null","description":"Custodian/exchange name. Required with `exchange` custody when `capabilities` is `fx` alone, and not accepted with `self` custody there","uniqueKey":"oneOf.0.external-wallets.items.[INDEX].custodian-name.oneOf.1","typeLabel":"null"}],"uniqueKey":"oneOf.0.external-wallets.items.[INDEX].custodian-name","typeLabel":"string | null"},"owner-type":{"oneOf":[{"type":"string","description":"Whether the account holder owns the wallet or someone else does. Required when `capabilities` is `fx` alone. A wallet with `rewards` belongs to the holder, so it accepts `account-holder` only","enum":["account-holder","third-party"],"example":"third-party","uniqueKey":"oneOf.0.external-wallets.items.[INDEX].owner-type.oneOf.0","typeLabel":"enum\u003cstring>"},{"type":"null","description":"Whether the account holder owns the wallet or someone else does. Required when `capabilities` is `fx` alone. A wallet with `rewards` belongs to the holder, so it accepts `account-holder` only","example":"third-party","uniqueKey":"oneOf.0.external-wallets.items.[INDEX].owner-type.oneOf.1","typeLabel":"null"}],"uniqueKey":"oneOf.0.external-wallets.items.[INDEX].owner-type","typeLabel":"enum\u003cstring> | null"},"owner-name":{"oneOf":[{"type":"string","description":"Legal name of the wallet's owner. Required with `owner-type` `third-party`, and not accepted otherwise","minLength":1,"example":"Acme Ltd","uniqueKey":"oneOf.0.external-wallets.items.[INDEX].owner-name.oneOf.0","typeLabel":"string"},{"type":"null","description":"Legal name of the wallet's owner. Required with `owner-type` `third-party`, and not accepted otherwise","example":"Acme Ltd","uniqueKey":"oneOf.0.external-wallets.items.[INDEX].owner-name.oneOf.1","typeLabel":"null"}],"uniqueKey":"oneOf.0.external-wallets.items.[INDEX].owner-name","typeLabel":"string | null"}},"additionalProperties":false,"required":["address"],"uniqueKey":"oneOf.0.external-wallets.items.[INDEX]","typeLabel":"object"},"uniqueKey":"oneOf.0.external-wallets","typeLabel":"object[]"}},"additionalProperties":false,"uniqueKey":"oneOf.0","typeLabel":"Brazilian Company · object"},{"type":"object","title":"Foreign Company","description":"A company whose tax residence is outside Brazil. No single register answers for it, so the body carries the company's own profile and its corporate documents alongside the people behind it","required":["identifiers","tax-residence","legal-name","headquarters-address","financial-profile","reward-tier","corporate-documents","related-parties"],"properties":{"identifiers":{"type":"array","description":"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","items":{"type":"object","properties":{"value":{"type":"string","description":"The number the register issued the company: a CNPJ when country is BRA","example":"98-7654321","isRequired":true,"uniqueKey":"oneOf.1.identifiers.items.[INDEX].value","typeLabel":"string"},"country":{"type":"string","description":"Country whose register issued the number, ISO-3","example":"CYM","isRequired":true,"uniqueKey":"oneOf.1.identifiers.items.[INDEX].country","typeLabel":"string"},"type":{"type":"string","enum":["tax-id","registration-number"],"description":"Which of the two numbers a foreign register issues this is: the country's tax identification, or the number the company is registered by at the registrar. Required outside BRA and not accepted under it, where the CNPJ is the only number the register issues","example":"registration-number","uniqueKey":"oneOf.1.identifiers.items.[INDEX].type","typeLabel":"enum\u003cstring>"}},"additionalProperties":false,"required":["value","country"],"uniqueKey":"oneOf.1.identifiers.items.[INDEX]","typeLabel":"object"},"example":[{"type":"registration-number","value":"98-7654321","country":"CYM"},{"value":"12345678000195","country":"BRA"}],"isRequired":true,"uniqueKey":"oneOf.1.identifiers","typeLabel":"object[]"},"tax-residence":{"type":"string","description":"Tax residence country, ISO-3. Any country other than BRA","example":"CYM","isRequired":true,"uniqueKey":"oneOf.1.tax-residence","typeLabel":"string"},"legal-name":{"type":"string","description":"The name the company is registered under","example":"Acme Holdings Ltd","isRequired":true,"uniqueKey":"oneOf.1.legal-name","typeLabel":"string"},"headquarters-address":{"type":"object","properties":{"postal-code":{"type":"string","example":"KY1-1104","isRequired":true,"uniqueKey":"oneOf.1.headquarters-address.postal-code","typeLabel":"string"},"line1":{"type":"string","example":"190 Elgin Avenue","isRequired":true,"uniqueKey":"oneOf.1.headquarters-address.line1","typeLabel":"string"},"city":{"type":"string","example":"George Town","isRequired":true,"uniqueKey":"oneOf.1.headquarters-address.city","typeLabel":"string"},"country":{"type":"string","description":"ISO 3166-1 alpha-3 country code","example":"CYM","isRequired":true,"uniqueKey":"oneOf.1.headquarters-address.country","typeLabel":"string"},"line2":{"type":"string","description":"Empty when there is nothing to add to line1","uniqueKey":"oneOf.1.headquarters-address.line2","typeLabel":"string"},"state":{"type":"string","description":"Required when country is BRA, where it must be the two-letter federal unit code","example":"Grand Cayman","uniqueKey":"oneOf.1.headquarters-address.state","typeLabel":"string"}},"additionalProperties":false,"required":["postal-code","line1","city","country"],"description":"Where the company is headquartered. state is required when country is BRA, where it must be the two-letter federal unit code","isRequired":true,"uniqueKey":"oneOf.1.headquarters-address","typeLabel":"object"},"financial-profile":{"type":"object","description":"What the company does, earns and owns, with the files that evidence it","properties":{"sector":{"type":"string","enum":["other","gambling","weapons","adult","mining","remittances","crypto","art","realty","vehicles","nonprofits","tcsp","scrap","hospitality","factoring","trade","construction","agribusiness","consulting"],"description":"The economic activity the company operates in. `other` covers every activity outside the sectors named below. A named sector is sent only when the company's activity falls within it:\n\n| Value | Description |\n|---|---|\n| `other` | Every economic activity not named below |\n| `gambling` | Gambling and betting, including online betting and casinos |\n| `weapons` | Weapons, ammunition and military equipment |\n| `adult` | Adult content |\n| `mining` | Mining, prospecting and trade of precious metals and stones |\n| `remittances` | Foreign exchange, international remittances and banking correspondent services |\n| `crypto` | Crypto assets and virtual assets |\n| `art` | Art, antiques and auctions |\n| `realty` | Real estate brokerage |\n| `vehicles` | Trade of vehicles, aircraft and vessels |\n| `nonprofits` | Nonprofit organizations and religious entities |\n| `tcsp` | Company and trust formation and administration services |\n| `scrap` | Trade and recycling of scrap and recyclable materials |\n| `hospitality` | Bars, restaurants, nightclubs and events |\n| `factoring` | Cash-in-transit (armored transport) and factoring services |\n| `trade` | Foreign trade, import and export |\n| `construction` | Construction and real estate development |\n| `agribusiness` | Agriculture, livestock, logging and trade of agricultural commodities |\n| `consulting` | Business consulting and advisory services with no specific defined activity |","example":"other","isRequired":true,"uniqueKey":"oneOf.1.financial-profile.sector","typeLabel":"enum\u003cstring>"},"currency":{"type":"string","enum":["BRL","USD"],"description":"The one currency every amount below is declared in","example":"BRL","isRequired":true,"uniqueKey":"oneOf.1.financial-profile.currency","typeLabel":"enum\u003cstring>"},"monthly-income":{"type":"number","format":"double","description":"What the company earns monthly, its average monthly revenue over the last 12 months","example":250000,"isRequired":true,"uniqueKey":"oneOf.1.financial-profile.monthly-income","typeLabel":"number\u003cdouble>"},"revenue-statement-file-ids":{"type":"array","items":{"type":"string","pattern":"^ev_[A-Z0-9]+$","example":"ev_019712CFC86D703F85B8BDAA4FC8D254","uniqueKey":"oneOf.1.financial-profile.revenue-statement-file-ids.items.[INDEX]","typeLabel":"string"},"minItems":1,"description":"Evidence of the last 12 months' revenue. Several files when the statement comes split by period","isRequired":true,"uniqueKey":"oneOf.1.financial-profile.revenue-statement-file-ids","typeLabel":"string[]"},"net-worth":{"type":"number","format":"double","description":"Everything the company owns, net of debt","example":5000000,"uniqueKey":"oneOf.1.financial-profile.net-worth","typeLabel":"number\u003cdouble>"},"source-of-funds":{"type":"array","minItems":1,"items":{"type":"string","uniqueKey":"oneOf.1.financial-profile.source-of-funds.items.[INDEX]","typeLabel":"string"},"description":"Where the company's funds come from, each source in the partner's own words","example":["Revenue from software licensing"],"uniqueKey":"oneOf.1.financial-profile.source-of-funds","typeLabel":"string[]"},"bank-statement-file-ids":{"type":"array","items":{"type":"string","pattern":"^ev_[A-Z0-9]+$","example":"ev_019712CFC86D703F85B8BDAA4FC8D254","uniqueKey":"oneOf.1.financial-profile.bank-statement-file-ids.items.[INDEX]","typeLabel":"string"},"minItems":1,"description":"Bank statements for the last 3 months, one file per statement or a single consolidated one","uniqueKey":"oneOf.1.financial-profile.bank-statement-file-ids","typeLabel":"string[]"}},"additionalProperties":false,"required":["sector","currency","monthly-income","revenue-statement-file-ids"],"isRequired":true,"uniqueKey":"oneOf.1.financial-profile","typeLabel":"object"},"reward-tier":{"type":"number","format":"double","enum":[93.5,90,97],"description":"CDI reward tier (%) for the account. The parent account must hold the matching subaccounts-\u003ctier>-tier capability.","example":97,"isRequired":true,"uniqueKey":"oneOf.1.reward-tier","typeLabel":"enum\u003cnumber>"},"corporate-documents":{"type":"array","items":{"type":"string","pattern":"^ev_[A-Z0-9]+$","example":"ev_019712CFC86D703F85B8BDAA4FC8D254","uniqueKey":"oneOf.1.corporate-documents.items.[INDEX]","typeLabel":"string"},"minItems":1,"description":"Every corporate document the company has, each file referenced by the id returned from POST /v1/accounts/files. A multi-page instrument is one file and one id:\n\n- The instrument that constitutes the company, whatever its jurisdiction calls it: certificate of incorporation, articles of incorporation, memorandum and articles of association, bylaws, operating agreement, contrato social, estatuto social or the local equivalent.\n- Every amendment to it, and its latest consolidated version.\n- Certificates the registrar issues on the company, such as a certificate of good standing or of incumbency.\n- The registers of directors and of shareholders or members, and the shareholders' agreement when there is one.","isRequired":true,"uniqueKey":"oneOf.1.corporate-documents","typeLabel":"string[]"},"related-parties":{"type":"array","minItems":1,"items":{"type":"object","properties":{"first-name":{"type":"string","description":"The person's given name, as their identity document spells it","example":"Ana","isRequired":true,"uniqueKey":"oneOf.1.related-parties.items.[INDEX].first-name","typeLabel":"string"},"last-name":{"type":"string","description":"The person's family name, as their identity document spells it","example":"Silva","isRequired":true,"uniqueKey":"oneOf.1.related-parties.items.[INDEX].last-name","typeLabel":"string"},"date-of-birth":{"type":"string","format":"date","description":"Must be the birth date of someone at least 18 years old","example":"1990-04-12","isRequired":true,"uniqueKey":"oneOf.1.related-parties.items.[INDEX].date-of-birth","typeLabel":"string\u003cdate>"},"identifier":{"type":"object","properties":{"value":{"type":"string","description":"The number that identifies the person: a CPF when country is BRA, the passport number otherwise","example":"12345678909","isRequired":true,"uniqueKey":"oneOf.1.related-parties.items.[INDEX].identifier.value","typeLabel":"string"},"country":{"type":"string","description":"Country that issued the number, ISO-3. BRA means the number is a CPF; every other country means it is the passport that country issued","example":"BRA","isRequired":true,"uniqueKey":"oneOf.1.related-parties.items.[INDEX].identifier.country","typeLabel":"string"}},"additionalProperties":false,"required":["value","country"],"description":"How the person is identified. A Brazilian tax resident is identified by CPF, every other residence by passport","isRequired":true,"uniqueKey":"oneOf.1.related-parties.items.[INDEX].identifier","typeLabel":"object"},"tax-residence":{"type":"string","description":"The person's own tax residence, ISO-3. It is read on its own, not against the company's","example":"BRA","isRequired":true,"uniqueKey":"oneOf.1.related-parties.items.[INDEX].tax-residence","typeLabel":"string"},"address":{"type":"object","properties":{"postal-code":{"type":"string","example":"01310-100","isRequired":true,"uniqueKey":"oneOf.1.related-parties.items.[INDEX].address.postal-code","typeLabel":"string"},"line1":{"type":"string","example":"Avenida Paulista, 1000","isRequired":true,"uniqueKey":"oneOf.1.related-parties.items.[INDEX].address.line1","typeLabel":"string"},"city":{"type":"string","example":"Sao Paulo","isRequired":true,"uniqueKey":"oneOf.1.related-parties.items.[INDEX].address.city","typeLabel":"string"},"country":{"type":"string","description":"ISO 3166-1 alpha-3 country code","example":"BRA","isRequired":true,"uniqueKey":"oneOf.1.related-parties.items.[INDEX].address.country","typeLabel":"string"},"line2":{"type":"string","description":"Empty when there is nothing to add to line1","uniqueKey":"oneOf.1.related-parties.items.[INDEX].address.line2","typeLabel":"string"},"state":{"type":"string","description":"Required when country is BRA, where it must be the two-letter federal unit code","example":"SP","uniqueKey":"oneOf.1.related-parties.items.[INDEX].address.state","typeLabel":"string"}},"additionalProperties":false,"required":["postal-code","line1","city","country"],"description":"Where the person lives. state is required when country is BRA, where it must be the two-letter federal unit code","isRequired":true,"uniqueKey":"oneOf.1.related-parties.items.[INDEX].address","typeLabel":"object"},"document":{"type":"object","properties":{"front-file-id":{"type":"string","pattern":"^ev_[A-Z0-9]+$","description":"Front of the document, or the whole document in one file: an image, or a PDF of one or two pages","example":"ev_019712CFC86D703F85B8BDAA4FC8D254","isRequired":true,"uniqueKey":"oneOf.1.related-parties.items.[INDEX].document.front-file-id","typeLabel":"string"},"type":{"type":"string","enum":["rg","cnh","passport"],"description":"The person's identity document. Optional for a Brazilian tax resident, since the type is read from the image; every other residence sends passport","uniqueKey":"oneOf.1.related-parties.items.[INDEX].document.type","typeLabel":"enum\u003cstring>"},"back-file-id":{"type":"string","pattern":"^ev_[A-Z0-9]+$","description":"Back of the document, when it comes as a separate file. Not accepted for a passport, which is read from one page","example":"ev_019712CFC86D703F85B8BDAA4FC8D254","uniqueKey":"oneOf.1.related-parties.items.[INDEX].document.back-file-id","typeLabel":"string"}},"additionalProperties":false,"required":["front-file-id"],"description":"The person's identity document. Referenced ids come from POST /v1/accounts/files","isRequired":true,"uniqueKey":"oneOf.1.related-parties.items.[INDEX].document","typeLabel":"object"},"pep":{"type":"object","properties":{"declared":{"type":"boolean","description":"Whether the person is a politically exposed person, or related to one. When true the three detail fields below are all required","isRequired":true,"uniqueKey":"oneOf.1.related-parties.items.[INDEX].pep.declared","typeLabel":"boolean"},"full-name":{"type":"string","description":"Full name of the exposed person","uniqueKey":"oneOf.1.related-parties.items.[INDEX].pep.full-name","typeLabel":"string"},"role":{"type":"string","description":"Public role held","uniqueKey":"oneOf.1.related-parties.items.[INDEX].pep.role","typeLabel":"string"},"relationship":{"type":"string","enum":["self","spouse","child","parent","business_associate","other"],"description":"The holder's relationship to the exposed person","uniqueKey":"oneOf.1.related-parties.items.[INDEX].pep.relationship","typeLabel":"enum\u003cstring>"}},"additionalProperties":false,"required":["declared"],"isRequired":true,"uniqueKey":"oneOf.1.related-parties.items.[INDEX].pep","typeLabel":"object"},"roles":{"type":"array","minItems":1,"items":{"type":"string","enum":["representative","director","ubo"],"uniqueKey":"oneOf.1.related-parties.items.[INDEX].roles.items.[INDEX]","typeLabel":"enum\u003cstring>"},"description":"Every role the person holds in the company. One person is one entry, carrying the fields each of their roles asks for:\n\n| Value | Description |\n|---|---|\n| `representative` | Acts for the company. Sends `liveness` and `power-of-attorney-file-id` |\n| `director` | Sits on the company's management |\n| `ubo` | Ultimately owns more than 25% of the company. Sends `ownership-percentage` and `financial-profile` |","example":["representative","ubo"],"isRequired":true,"uniqueKey":"oneOf.1.related-parties.items.[INDEX].roles","typeLabel":"enum\u003cstring>[]"},"liveness":{"type":"object","properties":{"id":{"type":"string","description":"The session's id at the provider","isRequired":true,"uniqueKey":"oneOf.1.related-parties.items.[INDEX].liveness.id","typeLabel":"string"},"provider":{"type":"string","enum":["unico","sumsub","idwall","persona","idenfy"],"description":"Liveness provider that ran the session","example":"idwall","isRequired":true,"uniqueKey":"oneOf.1.related-parties.items.[INDEX].liveness.provider","typeLabel":"enum\u003cstring>"}},"additionalProperties":false,"required":["id","provider"],"description":"The liveness session the partner ran on the person. Required of a representative, and accepted of no one else","uniqueKey":"oneOf.1.related-parties.items.[INDEX].liveness","typeLabel":"object"},"power-of-attorney-file-id":{"type":"string","pattern":"^ev_[A-Z0-9]+$","description":"The instrument appointing the person to act for the company. Required of a representative, and accepted of no one else. Referenced by the id returned from POST /v1/accounts/files","example":"ev_019712CFC86D703F85B8BDAA4FC8D254","uniqueKey":"oneOf.1.related-parties.items.[INDEX].power-of-attorney-file-id","typeLabel":"string"},"ownership-percentage":{"type":"number","format":"double","exclusiveMinimum":0,"maximum":100,"description":"How much of the company the person ultimately owns. Required of a ubo, and accepted of no one else","example":35,"uniqueKey":"oneOf.1.related-parties.items.[INDEX].ownership-percentage","typeLabel":"number\u003cdouble>"},"financial-profile":{"type":"object","description":"What the person owns, net of debt. Required of a ubo, and accepted of no one else","properties":{"currency":{"type":"string","enum":["BRL","USD"],"description":"The one currency every amount below is declared in","example":"BRL","isRequired":true,"uniqueKey":"oneOf.1.related-parties.items.[INDEX].financial-profile.currency","typeLabel":"enum\u003cstring>"},"net-worth":{"type":"number","format":"double","description":"Everything the person owns, net of debt","example":850000,"isRequired":true,"uniqueKey":"oneOf.1.related-parties.items.[INDEX].financial-profile.net-worth","typeLabel":"number\u003cdouble>"}},"additionalProperties":false,"required":["currency","net-worth"],"uniqueKey":"oneOf.1.related-parties.items.[INDEX].financial-profile","typeLabel":"object"}},"additionalProperties":false,"required":["first-name","last-name","date-of-birth","identifier","tax-residence","address","document","pep","roles"],"uniqueKey":"oneOf.1.related-parties.items.[INDEX]","typeLabel":"object"},"description":"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","isRequired":true,"uniqueKey":"oneOf.1.related-parties","typeLabel":"object[]"},"trade-name":{"type":"string","description":"The name the company trades under, when it differs from the registered one","example":"Acme","uniqueKey":"oneOf.1.trade-name","typeLabel":"string"},"giin":{"type":"string","description":"The Global Intermediary Identification Number the IRS issued the company under FATCA. Only a financial institution registered there holds one","example":"ABC123.00000.LE.136","uniqueKey":"oneOf.1.giin","typeLabel":"string"},"external-wallets":{"type":"array","description":"The account's destination wallets, at most 5","maxItems":5,"items":{"type":"object","properties":{"address":{"type":"string","description":"On-chain destination address","example":"0xabc...","isRequired":true,"uniqueKey":"oneOf.1.external-wallets.items.[INDEX].address","typeLabel":"string"},"capabilities":{"type":"array","items":{"type":"string","enum":["fx","rewards"],"uniqueKey":"oneOf.1.external-wallets.items.[INDEX].capabilities.items.[INDEX]","typeLabel":"enum\u003cstring>"},"minItems":1,"uniqueItems":true,"description":"What the wallet is for. A wallet with `rewards` earns the account's rewards, receives FX payouts too, and belongs to that account alone. A wallet with `fx` alone only receives FX payouts, and several accounts can declare the same one. Omitted, the wallet does both","example":["fx"],"uniqueKey":"oneOf.1.external-wallets.items.[INDEX].capabilities","typeLabel":"enum\u003cstring>[]"},"custody-country":{"oneOf":[{"type":"string","description":"Custodian country, ISO-3. Required when `capabilities` is `fx` alone","example":"BRA","uniqueKey":"oneOf.1.external-wallets.items.[INDEX].custody-country.oneOf.0","typeLabel":"string"},{"type":"null","description":"Custodian country, ISO-3. Required when `capabilities` is `fx` alone","example":"BRA","uniqueKey":"oneOf.1.external-wallets.items.[INDEX].custody-country.oneOf.1","typeLabel":"null"}],"uniqueKey":"oneOf.1.external-wallets.items.[INDEX].custody-country","typeLabel":"string | null"},"custody-type":{"oneOf":[{"type":"string","description":"Self-custody or exchange custody. Required when `capabilities` is `fx` alone","enum":["self","exchange"],"uniqueKey":"oneOf.1.external-wallets.items.[INDEX].custody-type.oneOf.0","typeLabel":"enum\u003cstring>"},{"type":"null","description":"Self-custody or exchange custody. Required when `capabilities` is `fx` alone","uniqueKey":"oneOf.1.external-wallets.items.[INDEX].custody-type.oneOf.1","typeLabel":"null"}],"uniqueKey":"oneOf.1.external-wallets.items.[INDEX].custody-type","typeLabel":"enum\u003cstring> | null"},"custodian-name":{"oneOf":[{"type":"string","description":"Custodian/exchange name. Required with `exchange` custody when `capabilities` is `fx` alone, and not accepted with `self` custody there","uniqueKey":"oneOf.1.external-wallets.items.[INDEX].custodian-name.oneOf.0","typeLabel":"string"},{"type":"null","description":"Custodian/exchange name. Required with `exchange` custody when `capabilities` is `fx` alone, and not accepted with `self` custody there","uniqueKey":"oneOf.1.external-wallets.items.[INDEX].custodian-name.oneOf.1","typeLabel":"null"}],"uniqueKey":"oneOf.1.external-wallets.items.[INDEX].custodian-name","typeLabel":"string | null"},"owner-type":{"oneOf":[{"type":"string","description":"Whether the account holder owns the wallet or someone else does. Required when `capabilities` is `fx` alone. A wallet with `rewards` belongs to the holder, so it accepts `account-holder` only","enum":["account-holder","third-party"],"example":"third-party","uniqueKey":"oneOf.1.external-wallets.items.[INDEX].owner-type.oneOf.0","typeLabel":"enum\u003cstring>"},{"type":"null","description":"Whether the account holder owns the wallet or someone else does. Required when `capabilities` is `fx` alone. A wallet with `rewards` belongs to the holder, so it accepts `account-holder` only","example":"third-party","uniqueKey":"oneOf.1.external-wallets.items.[INDEX].owner-type.oneOf.1","typeLabel":"null"}],"uniqueKey":"oneOf.1.external-wallets.items.[INDEX].owner-type","typeLabel":"enum\u003cstring> | null"},"owner-name":{"oneOf":[{"type":"string","description":"Legal name of the wallet's owner. Required with `owner-type` `third-party`, and not accepted otherwise","minLength":1,"example":"Acme Ltd","uniqueKey":"oneOf.1.external-wallets.items.[INDEX].owner-name.oneOf.0","typeLabel":"string"},{"type":"null","description":"Legal name of the wallet's owner. Required with `owner-type` `third-party`, and not accepted otherwise","example":"Acme Ltd","uniqueKey":"oneOf.1.external-wallets.items.[INDEX].owner-name.oneOf.1","typeLabel":"null"}],"uniqueKey":"oneOf.1.external-wallets.items.[INDEX].owner-name","typeLabel":"string | null"}},"additionalProperties":false,"required":["address"],"uniqueKey":"oneOf.1.external-wallets.items.[INDEX]","typeLabel":"object"},"uniqueKey":"oneOf.1.external-wallets","typeLabel":"object[]"}},"additionalProperties":false,"uniqueKey":"oneOf.1","typeLabel":"Foreign Company · object"}],"uniqueKey":"","typeLabel":"Brazilian Company · object | Foreign Company · object"},"examples":{"Example":{"title":"Example","value":{"identifiers":[{"value":"12345678000195","country":"BRA"}],"tax-residence":"BRA","legal-name":"Acme Servicos Ltda","reward-tier":97,"related-parties":[{"first-name":"Ana","last-name":"Silva","date-of-birth":"1990-04-12","identifier":{"value":"12345678909","country":"BRA"},"tax-residence":"BRA","address":{"postal-code":"01310-100","line1":"Avenida Paulista, 1000","city":"Sao Paulo","country":"BRA","line2":"\u003cstring>","state":"SP"},"document":{"front-file-id":"ev_019712CFC86D703F85B8BDAA4FC8D254","back-file-id":"ev_019712CFC86D703F85B8BDAA4FC8D254"},"pep":{"declared":true,"full-name":"\u003cstring>","role":"\u003cstring>"},"roles":["representative","ubo"],"power-of-attorney-file-id":"ev_019712CFC86D703F85B8BDAA4FC8D254","ownership-percentage":35}],"trade-name":"Acme","external-wallets":[{"address":"0xabc...","capabilities":["fx"],"custody-country":"BRA","custodian-name":"\u003cstring>","owner-type":"third-party","owner-name":"Acme Ltd"}]}}},"exampleType":"generated"}},"exampleType":"generated"},"responses":{"8b2594fd-71a1-4127-b24b-01ebba8103ae":{"description":"An equivalent non-terminal request already exists","content":{"application/json":{"schema":{"type":"object","properties":{"account":{"type":"object","properties":{"id":{"type":"string","format":"uuid","description":"Unique identifier of the account","example":"019712cf-c86d-703f-85b8-bdaa4fc8d254","isRequired":true,"uniqueKey":"account.id","typeLabel":"string\u003cuuid>"},"alias":{"oneOf":[{"type":"string","description":"Human-readable alias for the account","example":"Trading account","isRequired":true,"uniqueKey":"account.alias.oneOf.0","typeLabel":"string"},{"type":"null","description":"Human-readable alias for the account","example":"Trading account","isRequired":true,"uniqueKey":"account.alias.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"account.alias","typeLabel":"string | null"},"status":{"type":"string","description":"Current status of the account. A provisioned account is 'pending-setup' or 'active'. An account still being created is projected as pending, carrying its request status: 'pending', 'rejected', or 'provisioning-failed' (see ADR-0008).","example":"active","isRequired":true,"uniqueKey":"account.status","typeLabel":"string"},"external-id":{"oneOf":[{"type":"string","description":"External identifier associated with the account","example":"ext-12345","isRequired":true,"uniqueKey":"account.external-id.oneOf.0","typeLabel":"string"},{"type":"null","description":"External identifier associated with the account","example":"ext-12345","isRequired":true,"uniqueKey":"account.external-id.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"account.external-id","typeLabel":"string | null"},"created-at":{"type":"string","example":"2024-01-15T10:30:00Z","format":"date-time","isRequired":true,"uniqueKey":"account.created-at","typeLabel":"string\u003cdate-time>"},"parent-id":{"oneOf":[{"type":"string","description":"Parent account id when this account has a parent; null for a top-level account","format":"uuid","uniqueKey":"account.parent-id.oneOf.0","typeLabel":"string\u003cuuid>"},{"type":"null","description":"Parent account id when this account has a parent; null for a top-level account","uniqueKey":"account.parent-id.oneOf.1","typeLabel":"null"}],"uniqueKey":"account.parent-id","typeLabel":"string\u003cuuid> | null"}},"additionalProperties":false,"required":["id","alias","status","external-id","created-at"],"isRequired":true,"uniqueKey":"account","typeLabel":"object"}},"additionalProperties":false,"required":["account"],"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"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"}}}},"exampleType":"generated"}},"exampleType":"generated"},"ead1dba8-b099-42a6-b8a5-b5cf2c4ee2be":{"description":"Account creation requested","content":{"application/json":{"schema":{"type":"object","properties":{"account":{"type":"object","properties":{"id":{"type":"string","format":"uuid","description":"Unique identifier of the account","example":"019712cf-c86d-703f-85b8-bdaa4fc8d254","isRequired":true,"uniqueKey":"account.id","typeLabel":"string\u003cuuid>"},"alias":{"oneOf":[{"type":"string","description":"Human-readable alias for the account","example":"Trading account","isRequired":true,"uniqueKey":"account.alias.oneOf.0","typeLabel":"string"},{"type":"null","description":"Human-readable alias for the account","example":"Trading account","isRequired":true,"uniqueKey":"account.alias.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"account.alias","typeLabel":"string | null"},"status":{"type":"string","description":"Current status of the account. A provisioned account is 'pending-setup' or 'active'. An account still being created is projected as pending, carrying its request status: 'pending', 'rejected', or 'provisioning-failed' (see ADR-0008).","example":"active","isRequired":true,"uniqueKey":"account.status","typeLabel":"string"},"external-id":{"oneOf":[{"type":"string","description":"External identifier associated with the account","example":"ext-12345","isRequired":true,"uniqueKey":"account.external-id.oneOf.0","typeLabel":"string"},{"type":"null","description":"External identifier associated with the account","example":"ext-12345","isRequired":true,"uniqueKey":"account.external-id.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"account.external-id","typeLabel":"string | null"},"created-at":{"type":"string","example":"2024-01-15T10:30:00Z","format":"date-time","isRequired":true,"uniqueKey":"account.created-at","typeLabel":"string\u003cdate-time>"},"parent-id":{"oneOf":[{"type":"string","description":"Parent account id when this account has a parent; null for a top-level account","format":"uuid","uniqueKey":"account.parent-id.oneOf.0","typeLabel":"string\u003cuuid>"},{"type":"null","description":"Parent account id when this account has a parent; null for a top-level account","uniqueKey":"account.parent-id.oneOf.1","typeLabel":"null"}],"uniqueKey":"account.parent-id","typeLabel":"string\u003cuuid> | null"}},"additionalProperties":false,"required":["id","alias","status","external-id","created-at"],"isRequired":true,"uniqueKey":"account","typeLabel":"object"}},"additionalProperties":false,"required":["account"],"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"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"}}}},"exampleType":"generated"}},"exampleType":"generated"},"9fb15195-2548-4438-b809-8257a78130bb":{"description":"Bad request - Invalid input parameters","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"type":{"type":"string","isRequired":true,"uniqueKey":"error.type","typeLabel":"string"},"message":{"type":"string","isRequired":true,"uniqueKey":"error.message","typeLabel":"string"},"code":{"type":"string","isRequired":true,"uniqueKey":"error.code","typeLabel":"string"}},"additionalProperties":false,"required":["type","message","code"],"description":"Bad request error details","isRequired":true,"uniqueKey":"error","typeLabel":"object"}},"additionalProperties":false,"required":["error"],"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"error":{"type":"\u003cstring>","message":"\u003cstring>","code":"\u003cstring>"}}}},"exampleType":"generated"}},"exampleType":"generated"},"a8dd312c-2daf-47f2-9598-74cdc4df3788":{"description":"Forbidden - Access denied","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"type":{"type":"string","isRequired":true,"uniqueKey":"error.type","typeLabel":"string"},"message":{"type":"string","isRequired":true,"uniqueKey":"error.message","typeLabel":"string"},"code":{"type":"string","isRequired":true,"uniqueKey":"error.code","typeLabel":"string"}},"additionalProperties":false,"required":["type","message","code"],"description":"Forbidden access error details","isRequired":true,"uniqueKey":"error","typeLabel":"object"}},"additionalProperties":false,"required":["error"],"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"error":{"type":"\u003cstring>","message":"\u003cstring>","code":"\u003cstring>"}}}},"exampleType":"generated"}},"exampleType":"generated"},"d4ed30d3-1dbd-4029-a1f7-a826d98194a4":{"description":"Not found - Resource does not exist","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"type":{"type":"string","isRequired":true,"uniqueKey":"error.type","typeLabel":"string"},"message":{"type":"string","isRequired":true,"uniqueKey":"error.message","typeLabel":"string"},"code":{"type":"string","isRequired":true,"uniqueKey":"error.code","typeLabel":"string"}},"additionalProperties":false,"required":["type","message","code"],"description":"Resource not found error details","isRequired":true,"uniqueKey":"error","typeLabel":"object"}},"additionalProperties":false,"required":["error"],"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"error":{"type":"\u003cstring>","message":"\u003cstring>","code":"\u003cstring>"}}}},"exampleType":"generated"}},"exampleType":"generated"},"0ad10000-b100-41e3-89f2-93b5e7d0923f":{"description":"Unprocessable entity - Validation failed","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"type":{"type":"string","isRequired":true,"uniqueKey":"error.type","typeLabel":"string"},"message":{"type":"string","isRequired":true,"uniqueKey":"error.message","typeLabel":"string"},"code":{"type":"string","isRequired":true,"uniqueKey":"error.code","typeLabel":"string"}},"additionalProperties":false,"required":["type","message","code"],"description":"Validation error details","isRequired":true,"uniqueKey":"error","typeLabel":"object"}},"additionalProperties":false,"required":["error"],"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"error":{"type":"\u003cstring>","message":"\u003cstring>","code":"\u003cstring>"}}}},"exampleType":"generated"}},"exampleType":"generated"}},"security":{},"servers":{"ee89d649-0f73-4d69-b1b2-e951fc9f7e0e":{"url":"https://app.crown-brlv.com","description":"Production server"}}},"originalFileLocation":"api-reference/openapi.json"},"subdomain":"crown-2b36dce9","siteName":"Crown API Documentation","title":"Create Account (KYC, Company) - Crown API Documentation","navMaps":{"firstHrefInVersion":{"v1":{"href":"/api-reference/endpoint/v1/accounts/create-kyc-company-account","matchLevel":0},"v0":{"href":"/","matchLevel":4}},"firstHrefInLanguage":{}},"lastModified":"2026-10-27T02:25:46.532Z","originalFileLocation":"api-reference/endpoint/v1/accounts/create-kyc-company-account.mdx"},"headHtml":"\u003cscript data-mint-head>(function(){var d=document.documentElement,p=null;if(!p){try{p=localStorage.getItem(\"isDarkMode\")}catch(e){}if(p==='true')p='dark';else if(p==='false')p='light';if(p!=='light'\u0026\u0026p!=='dark'\u0026\u0026p!=='system')p=\"system\"}var r=p==='system'?(matchMedia(\"(prefers-color-scheme: dark)\").matches?'dark':'light'):p;d.classList.remove(r==='dark'?'light':'dark');d.classList.add(r);d.setAttribute(\"data-theme-preference\",p)})();\u003c/script>\u003cmeta data-mint-head name=\"description\" content=\"Requests onboarding of a company account whose verification Crown runs itself. The body carries the company profile plus the people behind it: every representative, director and ultimate beneficial owner, each with their identity document and, where their role asks for one, the liveness session and the power of attorney. Files travel as ids: upload each one with POST /v1/accounts/files, then reference the returned id here. tax-residence selects the body. A company resident in BRA sends the Brazilian Company body; every other company sends the Foreign Company body. 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 capability matching reward-tier, or the request is refused with 403. - identifiers carries at most one entry per country. - A company whose tax-residence is BRA must list its CNPJ under BRA, and may also list identifiers from other countries. A company resident abroad must list an identifier from outside Brazil, and may add further identifiers, including the CNPJ it holds under BRA. - An entry under BRA must be a valid CNPJ and carries no type. Every entry outside BRA carries a type. - headquarters-address.state is required when headquarters-address.country is BRA, where it must be the two-letter federal unit code (SP, RJ, MG, …). - For every entry in related-parties, identifier.country must be BRA exactly when that person\u0026#x27;s tax-residence is BRA, and a BRA identifier must be a valid CPF. Each person\u0026#x27;s identifier and residence are read on their own, not against the company\u0026#x27;s. - For every entry in related-parties, date-of-birth, address and document follow the same rules as an individual holder\u0026#x27;s. - At least one entry in related-parties holds the representative role. - liveness and power-of-attorney-file-id are required of every representative and rejected on anyone else. ownership-percentage and financial-profile are required of every ubo and rejected on anyone else. - The declared ownership-percentage values together cannot exceed 100. - The same person, by identifier, appears at most once in related-parties. - Every file id referenced in the body 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\u0026#x27;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.\">\u003cmeta data-mint-head name=\"application-name\" content=\"Crown API Documentation\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/crown-2b36dce9/b-hZSpiTYtCRSAkK/_generated/favicon/android-chrome-192x192.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"apple-touch-icon\" type=\"image/png\" sizes=\"180x180\" href=\"/mintlify-assets/_mintlify/favicons/crown-2b36dce9/b-hZSpiTYtCRSAkK/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/crown-2b36dce9/b-hZSpiTYtCRSAkK/_generated/favicon/favicon-16x16.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/crown-2b36dce9/b-hZSpiTYtCRSAkK/_generated/favicon/favicon-32x32.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/crown-2b36dce9/b-hZSpiTYtCRSAkK/_generated/favicon/favicon.ico\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/crown-2b36dce9/b-hZSpiTYtCRSAkK/_generated/favicon-dark/android-chrome-192x192.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/crown-2b36dce9/b-hZSpiTYtCRSAkK/_generated/favicon-dark/favicon-16x16.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/crown-2b36dce9/b-hZSpiTYtCRSAkK/_generated/favicon-dark/favicon-32x32.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/crown-2b36dce9/b-hZSpiTYtCRSAkK/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Create Account (KYC, Company) - Crown API Documentation\">\u003cmeta data-mint-head property=\"og:description\" content=\"Requests onboarding of a company account whose verification Crown runs itself. The body carries the company profile plus the people behind it: every representative, director and ultimate beneficial owner, each with their identity document and, where their role asks for one, the liveness session and the power of attorney. Files travel as ids: upload each one with POST /v1/accounts/files, then reference the returned id here. tax-residence selects the body. A company resident in BRA sends the Brazilian Company body; every other company sends the Foreign Company body. 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 capability matching reward-tier, or the request is refused with 403. - identifiers carries at most one entry per country. - A company whose tax-residence is BRA must list its CNPJ under BRA, and may also list identifiers from other countries. A company resident abroad must list an identifier from outside Brazil, and may add further identifiers, including the CNPJ it holds under BRA. - An entry under BRA must be a valid CNPJ and carries no type. Every entry outside BRA carries a type. - headquarters-address.state is required when headquarters-address.country is BRA, where it must be the two-letter federal unit code (SP, RJ, MG, …). - For every entry in related-parties, identifier.country must be BRA exactly when that person\u0026#x27;s tax-residence is BRA, and a BRA identifier must be a valid CPF. Each person\u0026#x27;s identifier and residence are read on their own, not against the company\u0026#x27;s. - For every entry in related-parties, date-of-birth, address and document follow the same rules as an individual holder\u0026#x27;s. - At least one entry in related-parties holds the representative role. - liveness and power-of-attorney-file-id are required of every representative and rejected on anyone else. ownership-percentage and financial-profile are required of every ubo and rejected on anyone else. - The declared ownership-percentage values together cannot exceed 100. - The same person, by identifier, appears at most once in related-parties. - Every file id referenced in the body 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\u0026#x27;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.\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"Crown API Documentation\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://docs.crown-brlv.com/api-reference/endpoint/v1/accounts/create-kyc-company-account\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://crown-2b36dce9.mintlify.site/_mintlify/api/og/v2?division=Accounts\u0026amp;title=Create+Account+%28KYC%2C+Company%29\u0026amp;description=Requests+onboarding+of+a+company+account+whose+verification+Crown+runs+itself.%0A%0AThe+body+carries+the+company+profile+plus+the+people+behind+it%3A+every+representa\u0026amp;theme=836d900ddc3ca50d0d899b9e\u0026amp;signature=a5aef466bbfc3a8b6024f1a47a132c2a38529b60b6b32a10a76cb64316f75808\">\u003cmeta data-mint-head property=\"og:image:width\" content=\"1200\">\u003cmeta data-mint-head property=\"og:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"twitter:card\" content=\"summary_large_image\">\u003cmeta data-mint-head name=\"twitter:title\" content=\"Create Account (KYC, Company) - Crown API Documentation\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Requests onboarding of a company account whose verification Crown runs itself. The body carries the company profile plus the people behind it: every representative, director and ultimate beneficial owner, each with their identity document and, where their role asks for one, the liveness session and the power of attorney. Files travel as ids: upload each one with POST /v1/accounts/files, then reference the returned id here. tax-residence selects the body. A company resident in BRA sends the Brazilian Company body; every other company sends the Foreign Company body. 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 capability matching reward-tier, or the request is refused with 403. - identifiers carries at most one entry per country. - A company whose tax-residence is BRA must list its CNPJ under BRA, and may also list identifiers from other countries. A company resident abroad must list an identifier from outside Brazil, and may add further identifiers, including the CNPJ it holds under BRA. - An entry under BRA must be a valid CNPJ and carries no type. Every entry outside BRA carries a type. - headquarters-address.state is required when headquarters-address.country is BRA, where it must be the two-letter federal unit code (SP, RJ, MG, …). - For every entry in related-parties, identifier.country must be BRA exactly when that person\u0026#x27;s tax-residence is BRA, and a BRA identifier must be a valid CPF. Each person\u0026#x27;s identifier and residence are read on their own, not against the company\u0026#x27;s. - For every entry in related-parties, date-of-birth, address and document follow the same rules as an individual holder\u0026#x27;s. - At least one entry in related-parties holds the representative role. - liveness and power-of-attorney-file-id are required of every representative and rejected on anyone else. ownership-percentage and financial-profile are required of every ubo and rejected on anyone else. - The declared ownership-percentage values together cannot exceed 100. - The same person, by identifier, appears at most once in related-parties. - Every file id referenced in the body 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\u0026#x27;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.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://crown-2b36dce9.mintlify.site/_mintlify/api/og/v2?division=Accounts\u0026amp;title=Create+Account+%28KYC%2C+Company%29\u0026amp;description=Requests+onboarding+of+a+company+account+whose+verification+Crown+runs+itself.%0A%0AThe+body+carries+the+company+profile+plus+the+people+behind+it%3A+every+representa\u0026amp;theme=836d900ddc3ca50d0d899b9e\u0026amp;signature=a5aef466bbfc3a8b6024f1a47a132c2a38529b60b6b32a10a76cb64316f75808\">\u003cmeta data-mint-head name=\"twitter:image:width\" content=\"1200\">\u003cmeta data-mint-head name=\"twitter:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"msapplication-config\" content=\"/mintlify-assets/_mintlify/favicons/crown-2b36dce9/b-hZSpiTYtCRSAkK/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"Crown API Documentation\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#002804\">\u003clink data-mint-head rel=\"canonical\" href=\"https://docs.crown-brlv.com/api-reference/endpoint/v1/accounts/create-kyc-company-account\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/api-reference/endpoint/v1/accounts/create-kyc-company-account.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://docs.crown-brlv.com/#organization\",\"name\":\"Crown API Documentation\",\"url\":\"https://docs.crown-brlv.com\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/crown-2b36dce9/-If___UpDLMLlFoP/logo/light.svg?fit=max\u0026auto=format\u0026n=-If___UpDLMLlFoP\u0026q=85\u0026s=ac83b7b6f874f0613ee2d0c9a5ade601\"}},{\"@type\":\"WebSite\",\"@id\":\"https://docs.crown-brlv.com#website\",\"name\":\"Crown API Documentation\",\"url\":\"https://docs.crown-brlv.com\",\"publisher\":{\"@id\":\"https://docs.crown-brlv.com/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://docs.crown-brlv.com/api-reference/endpoint/v1/accounts/create-kyc-company-account#webpage\",\"url\":\"https://docs.crown-brlv.com/api-reference/endpoint/v1/accounts/create-kyc-company-account\",\"name\":\"Create Account (KYC, Company)\",\"description\":\"Requests onboarding of a company account whose verification Crown runs itself. The body carries the company profile plus the people behind it: every representative, director and ultimate beneficial owner, each with their identity document and, where their role asks for one, the liveness session and the power of attorney. Files travel as ids: upload each one with POST /v1/accounts/files, then reference the returned id here. tax-residence selects the body. A company resident in BRA sends the Brazilian Company body; every other company sends the Foreign Company body. 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 capability matching reward-tier, or the request is refused with 403. - identifiers carries at most one entry per country. - A company whose tax-residence is BRA must list its CNPJ under BRA, and may also list identifiers from other countries. A company resident abroad must list an identifier from outside Brazil, and may add further identifiers, including the CNPJ it holds under BRA. - An entry under BRA must be a valid CNPJ and carries no type. Every entry outside BRA carries a type. - headquarters-address.state is required when headquarters-address.country is BRA, where it must be the two-letter federal unit code (SP, RJ, MG, …). - For every entry in related-parties, identifier.country must be BRA exactly when that person's tax-residence is BRA, and a BRA identifier must be a valid CPF. Each person's identifier and residence are read on their own, not against the company's. - For every entry in related-parties, date-of-birth, address and document follow the same rules as an individual holder's. - At least one entry in related-parties holds the representative role. - liveness and power-of-attorney-file-id are required of every representative and rejected on anyone else. ownership-percentage and financial-profile are required of every ubo and rejected on anyone else. - The declared ownership-percentage values together cannot exceed 100. - The same person, by identifier, appears at most once in related-parties. - Every file id referenced in the body 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.\",\"dateModified\":\"2026-10-27T02:25:46.532Z\",\"isPartOf\":{\"@id\":\"https://docs.crown-brlv.com#website\"},\"breadcrumb\":{\"@id\":\"https://docs.crown-brlv.com/api-reference/endpoint/v1/accounts/create-kyc-company-account#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.crown-brlv.com/api-reference/endpoint/v1/accounts/create-kyc-company-account#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Accounts\",\"item\":\"https://docs.crown-brlv.com/api-reference/endpoint/v1/accounts/list-accounts\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Create Account (KYC, Company)\",\"item\":\"https://docs.crown-brlv.com/api-reference/endpoint/v1/accounts/create-kyc-company-account\"}]},{\"@type\":[\"TechArticle\",\"APIReference\"],\"@id\":\"https://docs.crown-brlv.com/api-reference/endpoint/v1/accounts/create-kyc-company-account#apireference\",\"headline\":\"Create Account (KYC, Company)\",\"name\":\"Create Account (KYC, Company)\",\"description\":\"Requests onboarding of a company account whose verification Crown runs itself. The body carries the company profile plus the people behind it: every representative, director and ultimate beneficial owner, each with their identity document and, where their role asks for one, the liveness session and the power of attorney. Files travel as ids: upload each one with POST /v1/accounts/files, then reference the returned id here. tax-residence selects the body. A company resident in BRA sends the Brazilian Company body; every other company sends the Foreign Company body. 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 capability matching reward-tier, or the request is refused with 403. - identifiers carries at most one entry per country. - A company whose tax-residence is BRA must list its CNPJ under BRA, and may also list identifiers from other countries. A company resident abroad must list an identifier from outside Brazil, and may add further identifiers, including the CNPJ it holds under BRA. - An entry under BRA must be a valid CNPJ and carries no type. Every entry outside BRA carries a type. - headquarters-address.state is required when headquarters-address.country is BRA, where it must be the two-letter federal unit code (SP, RJ, MG, …). - For every entry in related-parties, identifier.country must be BRA exactly when that person's tax-residence is BRA, and a BRA identifier must be a valid CPF. Each person's identifier and residence are read on their own, not against the company's. - For every entry in related-parties, date-of-birth, address and document follow the same rules as an individual holder's. - At least one entry in related-parties holds the representative role. - liveness and power-of-attorney-file-id are required of every representative and rejected on anyone else. ownership-percentage and financial-profile are required of every ubo and rejected on anyone else. - The declared ownership-percentage values together cannot exceed 100. - The same person, by identifier, appears at most once in related-parties. - Every file id referenced in the body 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.\",\"url\":\"https://docs.crown-brlv.com/api-reference/endpoint/v1/accounts/create-kyc-company-account\",\"mainEntityOfPage\":{\"@id\":\"https://docs.crown-brlv.com/api-reference/endpoint/v1/accounts/create-kyc-company-account#webpage\"},\"dateModified\":\"2026-10-27T02:25:46.532Z\",\"publisher\":{\"@id\":\"https://docs.crown-brlv.com/#organization\"},\"isPartOf\":{\"@id\":\"https://docs.crown-brlv.com#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"Crown API Documentation\",\"publisher\":{\"@type\":\"Organization\",\"name\":\"Crown API Documentation\"},\"provider\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","agentPointerHref":"/api-reference/endpoint/v1/accounts/create-kyc-company-account.md","siteName":"Crown API Documentation","nav":{"global":null,"versions":[{"version":"v1","default":true,"tag":"Latest","tabs":[{"tab":"Guides","pages":[{"title":"Guides","href":""}]},{"tab":"API reference","groups":[{"group":"API documentation","pages":[{"title":"API Reference","href":"/api-reference/introduction"}]},{"group":"Accounts","pages":[{"title":"List Accounts","openapi":"GET /api/v1/accounts","href":"/api-reference/endpoint/v1/accounts/list-accounts"},{"title":"Create Account (Reliance)","openapi":"POST /api/v1/accounts/reliance","href":"/api-reference/endpoint/v1/accounts/create-reliance-account"},{"title":"Create Account (KYC, Individual)","openapi":"POST /api/v1/accounts/kyc/individual","description":"Requests onboarding of an individual account whose KYC Crown runs itself.\n\nThe 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.\n\nRequest-first: the response describes a creation request, not an account. The request enters compliance review and the account is provisioned on approval.\n\nEvery country code in the body is ISO 3166-1 alpha-3, read regardless of case: `bra` is read as `BRA`.\n\n**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:\n\n- 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`.\n- The parent must hold the `subaccounts-\u003ctier>-tier` capability matching `reward-tier`, or the request is refused with `403`.\n- `identifiers` carries at most one entry per country. No entry carries a `type`.\n- 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`.\n- An entry under `BRA` must be a valid CPF.\n- `date-of-birth` must be the birth date of someone at least 18 years old.\n- `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.\n- `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.\n- When `pep.declared` is `true`, `pep.full-name`, `pep.role` and `pep.relationship` are all required.\n- When `representative` is sent, its `identifier` must not be the number that identifies the holder.\n- `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.\n- `representative.document`, `representative.address` and `representative.pep` follow the same rules as the holder's `document`, `address` and `pep`.\n- 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`.\n- `external-wallets` holds at most 5 wallets, and their addresses must be unique within the request.\n- 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.\n- Any other wallet accepts `owner-type` `account-holder` only, and no `owner-name`.\n- 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.\n\n**Idempotency**: sending the same holder again while its request is `pending` returns that request with `200`, instead of creating a second one.","href":"/api-reference/endpoint/v1/accounts/create-kyc-individual-account"},{"title":"Create Account (KYC, Company)","openapi":"POST /api/v1/accounts/kyc/company","href":"/api-reference/endpoint/v1/accounts/create-kyc-company-account"},{"title":"Upload File","openapi":"POST /api/v1/accounts/files","description":"Uploads one file to be referenced by its id from a later kyc account request — one page of the holder's identity document, for instance. The file belongs to the authenticated partner: it is addressed under the account the token resolved, so one partner cannot reference another's. There is no single-use control — the same id may be referenced more than once. Accepts PDF, JPEG and PNG up to 10 MB; the type is detected from the file bytes, not from the declared content type. Requires the manage-holders capability.","href":"/api-reference/endpoint/v1/accounts/upload-file"},{"title":"Get Account","openapi":"GET /api/v1/accounts/{account-id}","href":"/api-reference/endpoint/v1/accounts/get-account"}]},{"group":"Orders","pages":[{"title":"List Orders","openapi":"GET /api/v1/accounts/{account-id}/orders","href":"/api-reference/endpoint/v1/orders/list-orders"},{"title":"List Orders by State","openapi":"GET /api/v1/orders","href":"/api-reference/endpoint/v1/orders/list-orders-by-state"},{"title":"Create Order","openapi":"POST /api/v1/accounts/{account-id}/orders","href":"/api-reference/endpoint/v1/orders/create-order"},{"title":"Get Order","openapi":"GET /api/v1/accounts/{account-id}/orders/{id}","href":"/api-reference/endpoint/v1/orders/get-order"}]},{"group":"Quotes","pages":[{"title":"Create Quote","openapi":"POST /api/v1/accounts/{account-id}/quotes","href":"/api-reference/endpoint/v1/quotes/create-quote"}]},{"group":"Wallets","pages":[{"title":"List Wallets","openapi":"GET /api/v1/accounts/{account-id}/wallets","href":"/api-reference/endpoint/v1/wallets/list-wallets"},{"title":"Create Wallet","openapi":"POST /api/v1/accounts/{account-id}/wallets","href":"/api-reference/endpoint/v1/wallets/create-wallet"},{"title":"Update Wallet Metadata","openapi":"PATCH /api/v1/accounts/{account-id}/wallets/{wallet-id}/metadata","href":"/api-reference/endpoint/v1/wallets/update-wallet-metadata"},{"title":"Issue External Wallet Challenge","openapi":"POST /api/v1/accounts/{account-id}/external-wallets/{address}/challenge","href":"/api-reference/endpoint/v1/wallets/issue-external-wallet-challenge"},{"title":"Whitelist External Wallet","openapi":"POST /api/v1/accounts/{account-id}/external-wallets","href":"/api-reference/endpoint/v1/wallets/whitelist-external-wallet"}]},{"group":"Transfers","pages":[{"title":"List Transfers","openapi":"GET /api/v1/accounts/{account-id}/transfers","href":"/api-reference/endpoint/v1/transfers/list-transfers"},{"title":"Transfer Tokens","openapi":"POST /api/v1/accounts/{account-id}/transfers","href":"/api-reference/endpoint/v1/transfers/create-transfer"}]},{"group":"NFT transfers","pages":[{"title":"List Reward Certificate NFT Transfers","openapi":"GET /api/v1/accounts/{account-id}/nft-transfers","href":"/api-reference/endpoint/v1/nft-transfers/list-nft-transfers"},{"title":"Transfer Reward Certificate NFT","openapi":"POST /api/v1/accounts/{account-id}/nft-transfers","href":"/api-reference/endpoint/v1/nft-transfers/create-nft-transfer"}]},{"group":"Withdrawals","pages":[{"title":"List Withdrawals","openapi":"GET /api/v1/accounts/{account-id}/withdrawals","href":"/api-reference/endpoint/v1/withdrawals/list-withdrawals"},{"title":"Create Withdrawal","openapi":"POST /api/v1/accounts/{account-id}/withdrawals","href":"/api-reference/endpoint/v1/withdrawals/create-withdrawal"},{"title":"Get Withdrawal","openapi":"GET /api/v1/accounts/{account-id}/withdrawals/{id}","href":"/api-reference/endpoint/v1/withdrawals/get-withdrawal"}]},{"group":"Deposits","pages":[{"title":"List Deposits by Asset","openapi":"GET /api/v1/accounts/{account-id}/assets/{asset}/deposits","href":"/api-reference/endpoint/v1/deposits/list-deposits"},{"title":"Get Deposit","openapi":"GET /api/v1/accounts/{account-id}/assets/{asset}/deposits/{id}","href":"/api-reference/endpoint/v1/deposits/get-deposit"},{"title":"Confirm Deposit Sender","openapi":"POST /api/v1/accounts/{account-id}/assets/{asset}/deposits/{id}/confirm-sender","href":"/api-reference/endpoint/v1/deposits/confirm-sender"},{"title":"Get PIX Deposit QR Code","openapi":"GET /api/v1/accounts/{account-id}/deposits/pix","href":"/api-reference/endpoint/v1/deposits/pix-deposit"}]},{"group":"Balance","pages":[{"title":"Get Balance by Asset","openapi":"GET /api/v1/accounts/{account-id}/assets/{asset}/balance","href":"/api-reference/endpoint/v1/balance/get-balance"}]},{"group":"Claims","pages":[{"title":"Get Claimable Balance","openapi":"GET /api/v1/accounts/{account-id}/claims","href":"/api-reference/endpoint/v1/claims/list-claims"},{"title":"Submit Claim Request","openapi":"POST /api/v1/accounts/{account-id}/claims","href":"/api-reference/endpoint/v1/claims/create-claim"},{"title":"Get Claim","openapi":"GET /api/v1/accounts/{account-id}/claims/{id}","href":"/api-reference/endpoint/v1/claims/get-claim"},{"title":"List Reward Certificates","openapi":"GET /api/v1/accounts/{account-id}/claims/certificates","href":"/api-reference/endpoint/v1/claims/list-certificates"},{"title":"Get Wallet Claimable Balance","openapi":"GET /api/v1/accounts/{account-id}/wallets/{wallet-address}/claims","href":"/api-reference/endpoint/v1/claims/wallet-claimable-balance"},{"title":"Submit Wallet Claim Request","openapi":"POST /api/v1/accounts/{account-id}/wallets/{wallet-address}/claims","href":"/api-reference/endpoint/v1/claims/create-wallet-claim"},{"title":"List Wallet Reward Certificates","openapi":"GET /api/v1/accounts/{account-id}/wallets/{wallet-address}/claims/certificates","href":"/api-reference/endpoint/v1/claims/list-wallet-certificates"}]},{"group":"Auto-claims","pages":[{"title":"List Auto-Claim Schedules","openapi":"GET /api/v1/accounts/{account-id}/auto-claims","href":"/api-reference/endpoint/v1/auto-claims/list-auto-claims"},{"title":"Create Auto-Claim Schedule","openapi":"POST /api/v1/accounts/{account-id}/auto-claims","href":"/api-reference/endpoint/v1/auto-claims/create-auto-claim"},{"title":"Get Auto-Claim Schedule","openapi":"GET /api/v1/accounts/{account-id}/auto-claims/{schedule-id}","href":"/api-reference/endpoint/v1/auto-claims/get-auto-claim"},{"title":"Pause Auto-Claim Schedule","openapi":"POST /api/v1/accounts/{account-id}/auto-claims/{schedule-id}/pause","href":"/api-reference/endpoint/v1/auto-claims/pause-auto-claim"},{"title":"Resume Auto-Claim Schedule","openapi":"POST /api/v1/accounts/{account-id}/auto-claims/{schedule-id}/resume","href":"/api-reference/endpoint/v1/auto-claims/resume-auto-claim"},{"title":"Cancel Auto-Claim Schedule","openapi":"DELETE /api/v1/accounts/{account-id}/auto-claims/{schedule-id}","href":"/api-reference/endpoint/v1/auto-claims/cancel-auto-claim"},{"title":"List Auto-Claim Skip Windows","openapi":"GET /api/v1/accounts/{account-id}/auto-claims/{schedule-id}/skips","href":"/api-reference/endpoint/v1/auto-claims/list-auto-claim-skips"},{"title":"Skip Auto-Claim","openapi":"POST /api/v1/accounts/{account-id}/auto-claims/{schedule-id}/skips","href":"/api-reference/endpoint/v1/auto-claims/create-auto-claim-skip"},{"title":"Remove Auto-Claim Skip Window","openapi":"DELETE /api/v1/accounts/{account-id}/auto-claims/{schedule-id}/skips/{skip-id}","href":"/api-reference/endpoint/v1/auto-claims/delete-auto-claim-skip"},{"title":"List Wallet Auto-Claim Schedules","openapi":"GET /api/v1/accounts/{account-id}/wallets/{wallet-address}/auto-claims","href":"/api-reference/endpoint/v1/auto-claims/list-wallet-auto-claims"},{"title":"Create Wallet Auto-Claim Schedule","openapi":"POST /api/v1/accounts/{account-id}/wallets/{wallet-address}/auto-claims","href":"/api-reference/endpoint/v1/auto-claims/create-wallet-auto-claim"}]},{"group":"Tax exemption","pages":[{"title":"Get Tax Exemption Progress","openapi":"GET /api/v1/accounts/{account-id}/tax-exemption/progress","href":"/api-reference/endpoint/v1/tax-exemption/progress"}]},{"group":"Webhooks","pages":[{"title":"Deposit Processed","openapi":"webhook deposit-processed","href":"/api-reference/webhooks/deposit-processed"},{"title":"Deposit Quarantined","openapi":"webhook deposit-quarantined","href":"/api-reference/webhooks/deposit-quarantined"},{"title":"Deposit Rejected","openapi":"webhook deposit-rejected","href":"/api-reference/webhooks/deposit-rejected"},{"title":"Order Completed","openapi":"webhook order-completed","href":"/api-reference/webhooks/order-completed"},{"title":"Order Refund Initiated","openapi":"webhook order-refund-initiated","href":"/api-reference/webhooks/order-refund-initiated"},{"title":"Token Transfer Completed","openapi":"webhook token-transfer-completed","href":"/api-reference/webhooks/token-transfer-completed"},{"title":"Withdraw Completed","openapi":"webhook withdraw-completed","href":"/api-reference/webhooks/withdraw-completed"},{"title":"Claim Completed","openapi":"webhook claim-completed","href":"/api-reference/webhooks/claim-completed"},{"title":"Account Approved","openapi":"webhook account-approved","href":"/api-reference/webhooks/account-approved"},{"title":"Account Rejected","openapi":"webhook account-rejected","href":"/api-reference/webhooks/account-rejected"}]}]},{"tab":"Whitepaper","pages":[{"title":"Whitepaper","href":"/whitepaper"}]}]},{"version":"v0","tag":"Deprecated","pages":[{"title":"v0","href":"/"}]}]},"basePath":"","title":"Create Account (KYC, Company) - Crown API Documentation","deploymentId":"dpl_DyXGnKeCjZyA3sUdfMJ7FjkdBefg","buildId":"dpl_DyXGnKeCjZyA3sUdfMJ7FjkdBefg","dynamics":["c2aa737661","2b790eda92","b0f84f53ff","a9bb46feb3"],"chunks":["OpenApiReferenceProvider-CiUHMMOm.js","snippetPresets-BgfXU7Bw.js","utils-DWvOwgy_.js","style-to-object-BY3JEAdk.js","utils-BN7RXSMJ.js","v4-DIgz8zy6.js","addUniqueKeysToSchema-CFw8bq89.js","conditional-requirements-CFM0id0Q.js","cloneDeep-CAwdfOU2.js","_Uint8Array-BJr8e-ZL.js","isObject-FP1Yky1u.js","ApiExamples-XX0UgMZK.js","usePlaygroundInputsStore-DXDFSa1V.js","shallow-CdX5aREi.js","isEqual-CoOaxexF.js","CodeSnippets-Cg2wpzWm.js","CodeSnippet-D_HwgQO_.js","getApiPlaygroundDisplay-CmCoerhe.js","Page-CVJ-f_k1.js","DynamicMarkdown-CQM9Bhbv.js","SectionHeading-DpbrP8nQ.js","icon-BPCgijHy.js","MethodPill-GQ8DuY0c.js","getPastedJson-Cb5mT31m.js","Check2Icon-a7bUI6e8.js","axios-CsQoIw0U.js","Markdown-CX2QY19L.js","AssistantPageLink-CY3bFglh.js","dist-Dl6_zDnT.js","lib-DMeTj1gb.js","lib-B8HbPgcC.js","katex-Dbtb6Wk7.js","html-void-elements-mCSPHezU.js","marked.esm-CZWythHk.js"]}