{"docsConfig":{"theme":"palm","$schema":"https://mintlify.com/docs.json","name":"Trace Finance","description":"Explore guides, examples, and API references to build with Trace Finance.","colors":{"primary":"#15803D","light":"#18E299","dark":"#0C8C5E"},"logo":{"light":"https://mintcdn.com/tracefinance/Z0lGetTZ5_xyIY5m/logo/light.svg?fit=max\u0026auto=format\u0026n=Z0lGetTZ5_xyIY5m\u0026q=85\u0026s=ba19c7b8c24c8e96c9966e48d66e0704","dark":"https://mintcdn.com/tracefinance/Z0lGetTZ5_xyIY5m/logo/dark.svg?fit=max\u0026auto=format\u0026n=Z0lGetTZ5_xyIY5m\u0026q=85\u0026s=5b72f9c311add7f96778c3ac791a4965"},"favicon":"https://mintcdn.com/tracefinance/Z0lGetTZ5_xyIY5m/favicon.svg?fit=max\u0026auto=format\u0026n=Z0lGetTZ5_xyIY5m\u0026q=85\u0026s=68646cf39b77bc31420bd7abfb28a392","api":{},"appearance":{"default":"dark"},"background":{"decoration":"gradient"},"navbar":{"links":[{"href":"https://dashboard.tracefinance.com/","label":"Dashboard"}]},"footer":{"socials":{"github":"https://github.com/tracefinance","linkedin":"https://linkedin.com/company/tracefinance"}},"search":{},"seo":{"indexing":"navigable"},"fonts":{"heading":{"family":"Inter","weight":600},"body":{"family":"Inter","weight":400}},"styling":{"eyebrows":"breadcrumbs","codeblocks":{"theme":"tokyo-night"},"latex":false},"contextual":{"options":["copy","view","claude","chatgpt","grok","cursor","mcp"],"display":"header"},"metadata":{"timestamp":false},"variables":{"sandboxUrl":"https://api.sandbox.tracefinance.com"},"navigation":{"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"tracefinance","hasAudioNarration":false,"actualSubdomain":"tracefinance","customDomains":["docs.tracefinance.com"],"gitSource":{"type":"github","owner":"tracefinance","repo":"api-docs","deployBranch":"main","contentDirectory":"","isPrivate":true,"mountPath":"","label":""},"chroma":{"liveDeploymentHistoryId":"6ab28633716060868ac36cac","collectionId":"d5136a41-32fa-468f-98ac-e71b41eabe6a","schemaVersion":"v3","latestBuiltDeploymentHistoryId":"6ab28633716060868ac36cac"},"feedback":{"thumbs":true,"issues":false,"edits":false},"entitlements":{"AI_CHAT":{"status":"ENABLED"},"WEB_MCP":{"status":"ENABLED"},"NARRATION":{"status":"ENABLED"}},"buildId":"6ab28633716060868ac36cac","clientVersion":"0.0.3971","searchFilterCounts":[{"language":"default","tag":"API Reference","count":53},{"language":"default","tag":"Guides","count":29},{"language":"default","tag":"Webhooks","count":28},{"language":"default","tag":"Events","count":15},{"language":"default","tag":"Accounts","count":13},{"language":"default","tag":"Operations","count":8},{"language":"default","tag":"Journeys","count":8},{"language":"default","tag":"Beneficiaries","count":7},{"language":"default","tag":"Operation","count":7},{"language":"default","tag":"API principles","count":7}]},"assistantConfig":{"enableAskAiButton":false,"enableStarterQuestions":false,"enableContextualStarterQuestions":false,"enableAskAiSearchBar":true},"basePath":"","hasChatPermissions":true,"hasWebMcpPermissions":true,"toggles":[{"name":"kill-isr","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":"editor-v7-file-tree","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":"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":"llms-txt-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"pause-universal-search-reconcile","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":"per-site-search-delta","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":"editor-private-page-search","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":"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":"editor-nav-generations","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":"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":"byok-sep-25","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":"vite-origin","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-agent-model-picker","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"billing-updated-9-15","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":"workos-enabled","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false}],"isAtlas":false,"googleFontsInlined":false},"customCss":[{"filePath":"style.css","content":":not(pre)>code{hyphens:none!important;-webkit-hyphens:none!important;word-break:normal!important;overflow-wrap:normal!important;white-space:nowrap!important}.navbar-link a{border:1px solid rgba(21,128,61,.25);border-radius:10px;padding:7px 22px!important;font-size:.8125rem;letter-spacing:.02em;font-weight:500;color:rgba(21,128,61,.85)!important;transition:all .25s ease}.dark .navbar-link a{border-color:rgba(24,226,153,.2);color:rgba(24,226,153,.7)!important}.navbar-link a:hover{border-color:rgba(21,128,61,.5);color:#15803d!important;background:rgba(21,128,61,.04)}.dark .navbar-link a:hover{border-color:rgba(24,226,153,.4);color:#18e299!important;background:rgba(24,226,153,.06)}"}],"page":{"pagePath":"api-reference/fx-account/accounts/update-account","slug":"/api-reference/fx-account/accounts/update-account","pageMetadata":{"title":"Update an account","description":"Replace the owner profile and asset selection for an account that has not been submitted for review yet.","openapi":"apis/fx-account/openapi.yml PATCH /v1/accounts/{accountId}","href":"/api-reference/fx-account/accounts/update-account"},"description":{"compiledSource":"\"use strict\";\nconst {jsx: _jsx} = arguments[0];\nconst {useMDXComponents: _provideComponents} = arguments[0];\nfunction _createMdxContent(props) {\n const _components = {\n p: \"p\",\n ..._provideComponents(),\n ...props.components\n };\n return _jsx(_components.p, {\n children: \"Replace the owner profile and asset selection for an account that has not been submitted for review yet.\"\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":{"codeStyling":{"theme":"tokyo-night"},"config":{},"pageMetadata":{"title":"Update an account","description":"Replace the owner profile and asset selection for an account that has not been submitted for review yet.","openapi":"apis/fx-account/openapi.yml PATCH /v1/accounts/{accountId}","href":"/api-reference/fx-account/accounts/update-account"}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[],"codeExamples":{}},"jsLinks":[],"openApiReferenceData":{"operation":{"operationId":"updateAccount","tags":["Accounts"],"summary":"Update an account","description":"Replace the owner profile and asset selection for an account that has not been submitted for review yet.","parameters":["42e77633-a8d9-46a5-8d30-ab33184d20ad","64369a9a-c259-487c-a8e9-55b80e831115","767046a4-6db7-4e92-877a-d8fa8ebcbde8"],"requestBody":"87f08f22-52ac-4247-aebc-2bf57d62b9a4","responses":{"200":"b49e3e67-27b3-4aff-a6c8-105ff3a74a06","400":"505150b1-0c5d-45d9-828a-4ccfa29f4c20","401":"95889bbc-f66f-43f3-b1fd-f55a9367a627","404":"7496c6f0-9948-4e66-a277-4e155e059806","422":"8f78fe28-ce34-44ee-9fc8-fed132f85180"},"method":"patch","type":"path","servers":["4aa4e9da-008d-4557-b355-1182d5c08ea1"],"security":["6a3df8c2-1f7c-4ec0-b29d-b6153c48d433"],"path":"/v1/accounts/{accountId}","baseUrlOptions":["https://api.sandbox.tracefinance.com"],"title":"Update an account","codeSamples":[],"requiredOnlyExamples":false,"requestExampleType":"generated","responseExampleType":"generated"},"dependencies":{"parameters":{"42e77633-a8d9-46a5-8d30-ab33184d20ad":{"name":"accountId","in":"path","required":true,"description":"UUID of the account.","schema":{"type":"string","format":"uuid","isRequired":true,"description":"UUID of the account.","uniqueKey":"","typeLabel":"string\u003cuuid>"}},"64369a9a-c259-487c-a8e9-55b80e831115":{"name":"X-Trace-Version","in":"header","required":false,"description":"API version. Omit to use the default version.","schema":{"type":"string","example":"1","isRequired":false,"description":"API version. Omit to use the default version.","uniqueKey":"","typeLabel":"string"}},"767046a4-6db7-4e92-877a-d8fa8ebcbde8":{"name":"X-Idempotency-Key","in":"header","required":true,"description":"Unique key to ensure idempotent request processing. Required on all `POST`, `PUT`, and `PATCH` requests.","schema":{"type":"string","format":"uuid","isRequired":true,"description":"Unique key to ensure idempotent request processing. Required on all `POST`, `PUT`, and `PATCH` requests.","uniqueKey":"","typeLabel":"string\u003cuuid>"}}},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","description":"Request body for updating an account. The supplied `owner` replaces the current owner profile; assets are not modifiable after creation.","properties":{"owner":{"oneOf":[{"type":"object","title":"Company","description":"The legal entity that owns the account. Discriminated by `type`.","required":["type","legalName","identificationDocument","industry","expectedMonthlyVolume","address"],"properties":{"type":{"type":"string","enum":["COMPANY"],"isRequired":true,"uniqueKey":"owner.oneOf.0.type","typeLabel":"enum\u003cstring>"},"legalName":{"type":"string","description":"Registered legal name of the company.","example":"Acme Ltda","isRequired":true,"uniqueKey":"owner.oneOf.0.legalName","typeLabel":"string"},"identificationDocument":{"type":"object","description":"Identification document of an owner or beneficial owner. Tax-id documents (for example `CNPJ`, `CPF`) are validated against the type-specific format rules, and their `type` implies the country, so `country` is omitted for them. Non-fiscal documents (`PASSPORT`) carry an explicit `country`.\n","properties":{"type":{"type":"string","description":"Type of identification document. Tax-id types are country-specific and the type itself implies the country (`CPF`/`CNPJ` are Brazilian, `CUIT`/`CUIL` are Argentine, `RUT_CL` is Chilean, etc.). The non-fiscal `PASSPORT` type carries no implied country, so a `country` must be supplied alongside it.\n","enum":["CPF","CNPJ","CUIT","CUIL","RUT_CL","RUT_UY","CI_UY","RUC","DNI_PE","NIT","CC","RFC","RUC_PY","CI_PY","NIPC","NIF_PT","CIF","NIF_ES","NIE","SIREN","SIRET","NIF_FR","PARTITA_IVA","CODICE_FISCALE","UST_IDNR","STEUER_ID","KVK","BSN","BCE","NN_BE","ORGANISATIONSNUMMER","PERSONNUMMER","ORGANISASJONSNUMMER","FODSELSNUMMER","UID_CH","AHV","VAT_GB","NIN","EIN","SSN","ITIN","BN_CA","SIN","ABN","TFN","USCC","CORPORATE_NUMBER_JP","MY_NUMBER","BRN_KR","RRN","GSTIN","PAN","INN_RU","COMPANY_NUMBER_IL","TEUDAT_ZEHUT","TRADE_LICENSE","EMIRATES_ID","CIPC","SA_ID","PASSPORT"],"example":"CNPJ","isRequired":true,"uniqueKey":"owner.oneOf.0.identificationDocument.type","typeLabel":"enum\u003cstring>"},"value":{"type":"string","description":"Document digits or alphanumeric value (depending on type).","example":"11222333000181","isRequired":true,"uniqueKey":"owner.oneOf.0.identificationDocument.value","typeLabel":"string"},"country":{"type":"string","description":"ISO 3166-1 alpha-2 country of the document. Present only for non-fiscal types such as `PASSPORT`; tax-id types derive it from `type`.\n","enum":["AF","AL","DZ","AS","AD","AO","AI","AQ","AG","AR","AM","AW","AU","AT","AZ","BS","BH","BD","BB","BY","BE","BZ","BJ","BM","BT","BO","BQ","BA","BW","BV","BR","IO","BN","BG","BF","BI","CV","KH","CM","CA","KY","CF","TD","CL","CN","CX","CC","CO","KM","CD","CG","CK","CR","HR","CU","CW","CY","CZ","CI","DK","DJ","DM","DO","EC","EG","SV","GQ","ER","EE","SZ","ET","FK","FO","FJ","FI","FR","GF","PF","TF","GA","GM","GE","DE","GH","GI","GR","GL","GD","GP","GU","GT","GG","GN","GW","GY","HT","HM","VA","HN","HK","HU","IS","IN","ID","IR","IQ","IE","IM","IL","IT","JM","JP","JE","JO","KZ","KE","KI","KP","KR","KW","KG","LA","LV","LB","LS","LR","LY","LI","LT","LU","MO","MG","MW","MY","MV","ML","MT","MH","MQ","MR","MU","YT","MX","FM","MD","MC","MN","ME","MS","MA","MZ","MM","NA","NR","NP","NL","NC","NZ","NI","NE","NG","NU","NF","MP","NO","OM","PK","PW","PS","PA","PG","PY","PE","PH","PN","PL","PT","PR","QA","MK","RO","RU","RW","RE","BL","SH","KN","LC","MF","PM","VC","WS","SM","ST","SA","SN","RS","SC","SL","SG","SX","SK","SI","SB","SO","ZA","GS","SS","ES","LK","SD","SR","SJ","SE","CH","SY","TW","TJ","TZ","TH","TL","TG","TK","TO","TT","TN","TR","TM","TC","TV","UG","UA","AE","GB","UM","US","UY","UZ","VU","VE","VN","VG","VI","WF","EH","YE","ZM","ZW","AX"],"example":"BR","uniqueKey":"owner.oneOf.0.identificationDocument.country","typeLabel":"enum\u003cstring>"}},"required":["value","type"],"isRequired":true,"uniqueKey":"owner.oneOf.0.identificationDocument","typeLabel":"object"},"industry":{"type":"string","description":"Industry classification of the company.","enum":["AGRICULTURE","AGRICULTURAL_FOOD_SUPPLY","ENERGY","ENERGY_OIL_GAS","RETAIL_GENERAL","ECOMMERCE_ONLINE_RETAIL","DISTRIBUTION_WHOLESALE","MOTOR_VEHICLE_RETAIL_PARTS","FIRST_HAND_CAR_RETAIL","SECOND_HAND_CAR_RETAIL","SPORTS_EQUIPMENT_RETAIL","TEXTILE_WHOLESALE","PRECIOUS_METALS_WHOLESALE","AIRCRAFT_AERONAUTIC_WHOLESALE","PRE_PRIMARY_PRIMARY_EDUCATION","SECONDARY_POST_SECONDARY_EDUCATION","HIGHER_EDUCATION","PRIVATE_EDUCATION_TRAINING_SERVICES","ARTS_MEDIA","VIDEO_TV_PRODUCTION","TELECOM_MEDIA","SPORTS_CLUBS_ASSOCIATIONS","SPORTS_COACHING","GAMING_EGAMING","PRODUCTION_CULTURAL_HANDMADE_GOODS","FASHION_PRODUCTION","PASSENGER_TRANSPORT","LEASING_TRANSPORT_EQUIPMENT","BANKING","INSURANCE","LENDING_CREDIT_SERVICES","INVESTMENT_ASSET_MANAGEMENT","FINANCIAL_SERVICES_NON_CRYPTO","PAYMENT_SERVICE_PROVIDERS","CRYPTO_EXCHANGE_CEX","WALLET_PROVIDER","CRYPTO_LIQUIDITY_MARKET_MAKERS","CRYPTO_MINING","WEB3_FINANCIAL_SERVICES","GAMBLING_CASINOS","ADULT_ENTERTAINMENT","MEDICAL_CARE_CLINICS","HEALTHCARE_SERVICES","MANUFACTURE_MEDICAL_SUPPLIES","PHARMACEUTICAL_MANUFACTURING","MEDICAL_PHARMACEUTICAL_SERVICES","DENTAL_CARE","VETERINARY_CARE","AERONAUTICS_AEROSPACE_MANUFACTURING","AUTOMOTIVE_MANUFACTURING","CONSTRUCTION_INFRASTRUCTURE","METAL_MANUFACTURING","WATER_GAS_PIPELINE_CONSTRUCTION","INDUSTRIAL_COMPANIES_GENERAL","PUBLIC_ADMINISTRATION","LOCAL_GOVERNMENT","PUBLIC_SERVICES_AUTHORITIES","NONPROFIT_CHARITY_ORGANIZATIONS","REAL_ESTATE_AGENCIES","REAL_ESTATE_DEVELOPERS","ONLINE_REAL_ESTATE_MARKETPLACES","INFORMATION_TECHNOLOGY_GENERAL","COMPUTER_HIGH_TECH_TELECOM","SOFTWARE_DEVELOPMENT","IT_INFRASTRUCTURE_FACILITIES_MANAGEMENT","COMPUTER_ELECTRONICS_REPAIR","CYBERSECURITY_INFORMATION_SECURITY","AUDIT_ACCOUNTING_TECHNOLOGY","TECHNOLOGY_CONSULTING","ENGINEERING_TECHNICAL_SERVICES","FREIGHT_LOGISTICS","TRANSPORTATION","HOTEL_HOSPITALITY","RESTAURANTS_CAFES","TOURISM","TRAVEL_AGENCIES","LEGAL_SERVICES","HUMAN_RESOURCES","CLEANING_MAINTENANCE_SERVICES","CULTURAL_GOODS_HANDICRAFTS_TRADE","FASHION_DESIGN","PRECIOUS_METALS_STONES","ENVIRONMENT_SUSTAINABILITY_SERVICES","ARMAMENT_DEFENSE_INDUSTRY","UNEMPLOYED_STUDENT_RETIRED","OTHERS"],"example":"SOFTWARE_DEVELOPMENT","isRequired":true,"uniqueKey":"owner.oneOf.0.industry","typeLabel":"enum\u003cstring>"},"expectedMonthlyVolume":{"type":"string","description":"Expected monthly transaction volume for the account owner, declared at onboarding for compliance review. Bucket bounds are expressed in the local currency of the owner; the bucket name reflects the inclusive lower bound and the inclusive upper bound (or `ABOVE_*` for the open-ended top bucket).","enum":["FROM_0_TO_50000","FROM_50001_TO_500000","FROM_500001_TO_5000000","FROM_5000001_TO_50000000","ABOVE_50000000"],"example":"FROM_0_TO_50000","isRequired":true,"uniqueKey":"owner.oneOf.0.expectedMonthlyVolume","typeLabel":"enum\u003cstring>"},"address":{"type":"object","properties":{"addressLine1":{"type":"string","example":"Rua das Flores, 100","isRequired":true,"uniqueKey":"owner.oneOf.0.address.addressLine1","typeLabel":"string"},"city":{"type":"string","example":"São Paulo","isRequired":true,"uniqueKey":"owner.oneOf.0.address.city","typeLabel":"string"},"state":{"type":"string","example":"SP","isRequired":true,"uniqueKey":"owner.oneOf.0.address.state","typeLabel":"string"},"country":{"type":"string","description":"ISO 3166-1 alpha-2 country code.","example":"BR","enum":["AF","AL","DZ","AS","AD","AO","AI","AQ","AG","AR","AM","AW","AU","AT","AZ","BS","BH","BD","BB","BY","BE","BZ","BJ","BM","BT","BO","BQ","BA","BW","BV","BR","IO","BN","BG","BF","BI","CV","KH","CM","CA","KY","CF","TD","CL","CN","CX","CC","CO","KM","CD","CG","CK","CR","HR","CU","CW","CY","CZ","CI","DK","DJ","DM","DO","EC","EG","SV","GQ","ER","EE","SZ","ET","FK","FO","FJ","FI","FR","GF","PF","TF","GA","GM","GE","DE","GH","GI","GR","GL","GD","GP","GU","GT","GG","GN","GW","GY","HT","HM","VA","HN","HK","HU","IS","IN","ID","IR","IQ","IE","IM","IL","IT","JM","JP","JE","JO","KZ","KE","KI","KP","KR","KW","KG","LA","LV","LB","LS","LR","LY","LI","LT","LU","MO","MG","MW","MY","MV","ML","MT","MH","MQ","MR","MU","YT","MX","FM","MD","MC","MN","ME","MS","MA","MZ","MM","NA","NR","NP","NL","NC","NZ","NI","NE","NG","NU","NF","MP","NO","OM","PK","PW","PS","PA","PG","PY","PE","PH","PN","PL","PT","PR","QA","MK","RO","RU","RW","RE","BL","SH","KN","LC","MF","PM","VC","WS","SM","ST","SA","SN","RS","SC","SL","SG","SX","SK","SI","SB","SO","ZA","GS","SS","ES","LK","SD","SR","SJ","SE","CH","SY","TW","TJ","TZ","TH","TL","TG","TK","TO","TT","TN","TR","TM","TC","TV","UG","UA","AE","GB","UM","US","UY","UZ","VU","VE","VN","VG","VI","WF","EH","YE","ZM","ZW","AX"],"isRequired":true,"uniqueKey":"owner.oneOf.0.address.country","typeLabel":"enum\u003cstring>"},"postalCode":{"type":"string","example":"01234-567","isRequired":true,"uniqueKey":"owner.oneOf.0.address.postalCode","typeLabel":"string"},"addressLine2":{"oneOf":[{"type":"string","example":"Suite 456","uniqueKey":"owner.oneOf.0.address.addressLine2.oneOf.0","typeLabel":"string"},{"type":"null","example":"Suite 456","uniqueKey":"owner.oneOf.0.address.addressLine2.oneOf.1","typeLabel":"null"}],"uniqueKey":"owner.oneOf.0.address.addressLine2","typeLabel":"string | null"}},"required":["addressLine1","city","state","country","postalCode"],"isRequired":true,"uniqueKey":"owner.oneOf.0.address","typeLabel":"object"},"incorporateDate":{"oneOf":[{"type":"string","format":"date","description":"Company incorporation date in ISO format (yyyy-MM-dd). Optional.","example":"2018-05-12","uniqueKey":"owner.oneOf.0.incorporateDate.oneOf.0","typeLabel":"string\u003cdate>"},{"type":"null","format":"date","description":"Company incorporation date in ISO format (yyyy-MM-dd). Optional.","example":"2018-05-12","uniqueKey":"owner.oneOf.0.incorporateDate.oneOf.1","typeLabel":"null"}],"uniqueKey":"owner.oneOf.0.incorporateDate","typeLabel":"string\u003cdate> | null"},"isStartup":{"oneOf":[{"type":"boolean","default":false,"description":"Whether the company is a startup. Optional.","example":false,"uniqueKey":"owner.oneOf.0.isStartup.oneOf.0","typeLabel":"boolean"},{"type":"null","default":false,"description":"Whether the company is a startup. Optional.","example":false,"uniqueKey":"owner.oneOf.0.isStartup.oneOf.1","typeLabel":"null"}],"uniqueKey":"owner.oneOf.0.isStartup","typeLabel":"boolean | null"}},"isRequired":true,"uniqueKey":"owner.oneOf.0","typeLabel":"Company · object"},{"type":"object","title":"Individual","description":"The legal entity that owns the account. Discriminated by `type`.","required":["type","firstName","lastName","identificationDocument","expectedMonthlyVolume","address"],"properties":{"type":{"type":"string","enum":["INDIVIDUAL"],"isRequired":true,"uniqueKey":"owner.oneOf.1.type","typeLabel":"enum\u003cstring>"},"firstName":{"type":"string","description":"First name of the individual.","example":"Maria","isRequired":true,"uniqueKey":"owner.oneOf.1.firstName","typeLabel":"string"},"lastName":{"type":"string","description":"Last name of the individual.","example":"Silva","isRequired":true,"uniqueKey":"owner.oneOf.1.lastName","typeLabel":"string"},"identificationDocument":{"type":"object","description":"Identification document of an owner or beneficial owner. Tax-id documents (for example `CNPJ`, `CPF`) are validated against the type-specific format rules, and their `type` implies the country, so `country` is omitted for them. Non-fiscal documents (`PASSPORT`) carry an explicit `country`.\n","properties":{"type":{"type":"string","description":"Type of identification document. Tax-id types are country-specific and the type itself implies the country (`CPF`/`CNPJ` are Brazilian, `CUIT`/`CUIL` are Argentine, `RUT_CL` is Chilean, etc.). The non-fiscal `PASSPORT` type carries no implied country, so a `country` must be supplied alongside it.\n","enum":["CPF","CNPJ","CUIT","CUIL","RUT_CL","RUT_UY","CI_UY","RUC","DNI_PE","NIT","CC","RFC","RUC_PY","CI_PY","NIPC","NIF_PT","CIF","NIF_ES","NIE","SIREN","SIRET","NIF_FR","PARTITA_IVA","CODICE_FISCALE","UST_IDNR","STEUER_ID","KVK","BSN","BCE","NN_BE","ORGANISATIONSNUMMER","PERSONNUMMER","ORGANISASJONSNUMMER","FODSELSNUMMER","UID_CH","AHV","VAT_GB","NIN","EIN","SSN","ITIN","BN_CA","SIN","ABN","TFN","USCC","CORPORATE_NUMBER_JP","MY_NUMBER","BRN_KR","RRN","GSTIN","PAN","INN_RU","COMPANY_NUMBER_IL","TEUDAT_ZEHUT","TRADE_LICENSE","EMIRATES_ID","CIPC","SA_ID","PASSPORT"],"example":"CNPJ","isRequired":true,"uniqueKey":"owner.oneOf.1.identificationDocument.type","typeLabel":"enum\u003cstring>"},"value":{"type":"string","description":"Document digits or alphanumeric value (depending on type).","example":"11222333000181","isRequired":true,"uniqueKey":"owner.oneOf.1.identificationDocument.value","typeLabel":"string"},"country":{"type":"string","description":"ISO 3166-1 alpha-2 country of the document. Present only for non-fiscal types such as `PASSPORT`; tax-id types derive it from `type`.\n","enum":["AF","AL","DZ","AS","AD","AO","AI","AQ","AG","AR","AM","AW","AU","AT","AZ","BS","BH","BD","BB","BY","BE","BZ","BJ","BM","BT","BO","BQ","BA","BW","BV","BR","IO","BN","BG","BF","BI","CV","KH","CM","CA","KY","CF","TD","CL","CN","CX","CC","CO","KM","CD","CG","CK","CR","HR","CU","CW","CY","CZ","CI","DK","DJ","DM","DO","EC","EG","SV","GQ","ER","EE","SZ","ET","FK","FO","FJ","FI","FR","GF","PF","TF","GA","GM","GE","DE","GH","GI","GR","GL","GD","GP","GU","GT","GG","GN","GW","GY","HT","HM","VA","HN","HK","HU","IS","IN","ID","IR","IQ","IE","IM","IL","IT","JM","JP","JE","JO","KZ","KE","KI","KP","KR","KW","KG","LA","LV","LB","LS","LR","LY","LI","LT","LU","MO","MG","MW","MY","MV","ML","MT","MH","MQ","MR","MU","YT","MX","FM","MD","MC","MN","ME","MS","MA","MZ","MM","NA","NR","NP","NL","NC","NZ","NI","NE","NG","NU","NF","MP","NO","OM","PK","PW","PS","PA","PG","PY","PE","PH","PN","PL","PT","PR","QA","MK","RO","RU","RW","RE","BL","SH","KN","LC","MF","PM","VC","WS","SM","ST","SA","SN","RS","SC","SL","SG","SX","SK","SI","SB","SO","ZA","GS","SS","ES","LK","SD","SR","SJ","SE","CH","SY","TW","TJ","TZ","TH","TL","TG","TK","TO","TT","TN","TR","TM","TC","TV","UG","UA","AE","GB","UM","US","UY","UZ","VU","VE","VN","VG","VI","WF","EH","YE","ZM","ZW","AX"],"example":"BR","uniqueKey":"owner.oneOf.1.identificationDocument.country","typeLabel":"enum\u003cstring>"}},"required":["value","type"],"isRequired":true,"uniqueKey":"owner.oneOf.1.identificationDocument","typeLabel":"object"},"expectedMonthlyVolume":{"type":"string","description":"Expected monthly transaction volume for the account owner, declared at onboarding for compliance review. Bucket bounds are expressed in the local currency of the owner; the bucket name reflects the inclusive lower bound and the inclusive upper bound (or `ABOVE_*` for the open-ended top bucket).","enum":["FROM_0_TO_50000","FROM_50001_TO_500000","FROM_500001_TO_5000000","FROM_5000001_TO_50000000","ABOVE_50000000"],"example":"FROM_0_TO_50000","isRequired":true,"uniqueKey":"owner.oneOf.1.expectedMonthlyVolume","typeLabel":"enum\u003cstring>"},"address":{"type":"object","properties":{"addressLine1":{"type":"string","example":"Rua das Flores, 100","isRequired":true,"uniqueKey":"owner.oneOf.1.address.addressLine1","typeLabel":"string"},"city":{"type":"string","example":"São Paulo","isRequired":true,"uniqueKey":"owner.oneOf.1.address.city","typeLabel":"string"},"state":{"type":"string","example":"SP","isRequired":true,"uniqueKey":"owner.oneOf.1.address.state","typeLabel":"string"},"country":{"type":"string","description":"ISO 3166-1 alpha-2 country code.","example":"BR","enum":["AF","AL","DZ","AS","AD","AO","AI","AQ","AG","AR","AM","AW","AU","AT","AZ","BS","BH","BD","BB","BY","BE","BZ","BJ","BM","BT","BO","BQ","BA","BW","BV","BR","IO","BN","BG","BF","BI","CV","KH","CM","CA","KY","CF","TD","CL","CN","CX","CC","CO","KM","CD","CG","CK","CR","HR","CU","CW","CY","CZ","CI","DK","DJ","DM","DO","EC","EG","SV","GQ","ER","EE","SZ","ET","FK","FO","FJ","FI","FR","GF","PF","TF","GA","GM","GE","DE","GH","GI","GR","GL","GD","GP","GU","GT","GG","GN","GW","GY","HT","HM","VA","HN","HK","HU","IS","IN","ID","IR","IQ","IE","IM","IL","IT","JM","JP","JE","JO","KZ","KE","KI","KP","KR","KW","KG","LA","LV","LB","LS","LR","LY","LI","LT","LU","MO","MG","MW","MY","MV","ML","MT","MH","MQ","MR","MU","YT","MX","FM","MD","MC","MN","ME","MS","MA","MZ","MM","NA","NR","NP","NL","NC","NZ","NI","NE","NG","NU","NF","MP","NO","OM","PK","PW","PS","PA","PG","PY","PE","PH","PN","PL","PT","PR","QA","MK","RO","RU","RW","RE","BL","SH","KN","LC","MF","PM","VC","WS","SM","ST","SA","SN","RS","SC","SL","SG","SX","SK","SI","SB","SO","ZA","GS","SS","ES","LK","SD","SR","SJ","SE","CH","SY","TW","TJ","TZ","TH","TL","TG","TK","TO","TT","TN","TR","TM","TC","TV","UG","UA","AE","GB","UM","US","UY","UZ","VU","VE","VN","VG","VI","WF","EH","YE","ZM","ZW","AX"],"isRequired":true,"uniqueKey":"owner.oneOf.1.address.country","typeLabel":"enum\u003cstring>"},"postalCode":{"type":"string","example":"01234-567","isRequired":true,"uniqueKey":"owner.oneOf.1.address.postalCode","typeLabel":"string"},"addressLine2":{"oneOf":[{"type":"string","example":"Suite 456","uniqueKey":"owner.oneOf.1.address.addressLine2.oneOf.0","typeLabel":"string"},{"type":"null","example":"Suite 456","uniqueKey":"owner.oneOf.1.address.addressLine2.oneOf.1","typeLabel":"null"}],"uniqueKey":"owner.oneOf.1.address.addressLine2","typeLabel":"string | null"}},"required":["addressLine1","city","state","country","postalCode"],"isRequired":true,"uniqueKey":"owner.oneOf.1.address","typeLabel":"object"},"birthDate":{"oneOf":[{"type":"string","format":"date","description":"Date of birth in ISO format (yyyy-MM-dd). Optional.","example":"1990-03-21","uniqueKey":"owner.oneOf.1.birthDate.oneOf.0","typeLabel":"string\u003cdate>"},{"type":"null","format":"date","description":"Date of birth in ISO format (yyyy-MM-dd). Optional.","example":"1990-03-21","uniqueKey":"owner.oneOf.1.birthDate.oneOf.1","typeLabel":"null"}],"uniqueKey":"owner.oneOf.1.birthDate","typeLabel":"string\u003cdate> | null"}},"isRequired":true,"uniqueKey":"owner.oneOf.1","typeLabel":"Individual · object"}],"isRequired":true,"uniqueKey":"owner","typeLabel":"Company · object | Individual · object"}},"required":["owner"],"uniqueKey":"","typeLabel":"object"},"examples":{"company":{"title":"company","value":{"owner":{"type":"COMPANY","legalName":"Acme Ltda","identificationDocument":{"value":"11222333000181","type":"CNPJ"},"industry":"SOFTWARE_DEVELOPMENT","expectedMonthlyVolume":"FROM_0_TO_50000","incorporateDate":"2018-05-12","isStartup":false,"address":{"addressLine1":"Rua das Flores, 100","addressLine2":"Suite 456","city":"São Paulo","state":"SP","country":"BR","postalCode":"01234-567"}}}}},"exampleType":"examples"}},"exampleType":"examples"},"responses":{"b49e3e67-27b3-4aff-a6c8-105ff3a74a06":{"description":"Account updated.","headers":{"X-Request-Id":{"description":"Unique request identifier emitted on every response. Reference it when contacting Trace Finance support so we can trace the request end-to-end. See [Errors](/guides/principles/errors).","schema":{"type":"string","format":"uuid"}}},"content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string","format":"uuid","example":"a1b2c3d4-5e6f-7890-abcd-ef1234567890","readOnly":true,"isRequired":true,"uniqueKey":"id","typeLabel":"string\u003cuuid>"},"customer":{"type":"object","properties":{"id":{"type":"string","description":"Customer identifier.","example":"c1a2b3c4-d5e6-7890-abcd-ef1234567890","readOnly":true,"isRequired":true,"uniqueKey":"customer.id","typeLabel":"string"}},"required":["id"],"isRequired":true,"uniqueKey":"customer","typeLabel":"object"},"owner":{"oneOf":[{"type":"object","title":"Company","description":"The legal entity that owns the account. Discriminated by `type`.","required":["type","legalName","identificationDocument","industry","expectedMonthlyVolume","address","ubos"],"properties":{"type":{"type":"string","enum":["COMPANY"],"isRequired":true,"uniqueKey":"owner.oneOf.0.type","typeLabel":"enum\u003cstring>"},"legalName":{"type":"string","example":"Acme Ltda","isRequired":true,"uniqueKey":"owner.oneOf.0.legalName","typeLabel":"string"},"identificationDocument":{"type":"object","description":"Identification document of an owner or beneficial owner. Tax-id documents (for example `CNPJ`, `CPF`) are validated against the type-specific format rules, and their `type` implies the country, so `country` is omitted for them. Non-fiscal documents (`PASSPORT`) carry an explicit `country`.\n","properties":{"type":{"type":"string","description":"Type of identification document. Tax-id types are country-specific and the type itself implies the country (`CPF`/`CNPJ` are Brazilian, `CUIT`/`CUIL` are Argentine, `RUT_CL` is Chilean, etc.). The non-fiscal `PASSPORT` type carries no implied country, so a `country` must be supplied alongside it.\n","enum":["CPF","CNPJ","CUIT","CUIL","RUT_CL","RUT_UY","CI_UY","RUC","DNI_PE","NIT","CC","RFC","RUC_PY","CI_PY","NIPC","NIF_PT","CIF","NIF_ES","NIE","SIREN","SIRET","NIF_FR","PARTITA_IVA","CODICE_FISCALE","UST_IDNR","STEUER_ID","KVK","BSN","BCE","NN_BE","ORGANISATIONSNUMMER","PERSONNUMMER","ORGANISASJONSNUMMER","FODSELSNUMMER","UID_CH","AHV","VAT_GB","NIN","EIN","SSN","ITIN","BN_CA","SIN","ABN","TFN","USCC","CORPORATE_NUMBER_JP","MY_NUMBER","BRN_KR","RRN","GSTIN","PAN","INN_RU","COMPANY_NUMBER_IL","TEUDAT_ZEHUT","TRADE_LICENSE","EMIRATES_ID","CIPC","SA_ID","PASSPORT"],"example":"CNPJ","isRequired":true,"uniqueKey":"owner.oneOf.0.identificationDocument.type","typeLabel":"enum\u003cstring>"},"value":{"type":"string","description":"Document digits or alphanumeric value (depending on type).","example":"11222333000181","isRequired":true,"uniqueKey":"owner.oneOf.0.identificationDocument.value","typeLabel":"string"},"country":{"type":"string","description":"ISO 3166-1 alpha-2 country of the document. Present only for non-fiscal types such as `PASSPORT`; tax-id types derive it from `type`.\n","enum":["AF","AL","DZ","AS","AD","AO","AI","AQ","AG","AR","AM","AW","AU","AT","AZ","BS","BH","BD","BB","BY","BE","BZ","BJ","BM","BT","BO","BQ","BA","BW","BV","BR","IO","BN","BG","BF","BI","CV","KH","CM","CA","KY","CF","TD","CL","CN","CX","CC","CO","KM","CD","CG","CK","CR","HR","CU","CW","CY","CZ","CI","DK","DJ","DM","DO","EC","EG","SV","GQ","ER","EE","SZ","ET","FK","FO","FJ","FI","FR","GF","PF","TF","GA","GM","GE","DE","GH","GI","GR","GL","GD","GP","GU","GT","GG","GN","GW","GY","HT","HM","VA","HN","HK","HU","IS","IN","ID","IR","IQ","IE","IM","IL","IT","JM","JP","JE","JO","KZ","KE","KI","KP","KR","KW","KG","LA","LV","LB","LS","LR","LY","LI","LT","LU","MO","MG","MW","MY","MV","ML","MT","MH","MQ","MR","MU","YT","MX","FM","MD","MC","MN","ME","MS","MA","MZ","MM","NA","NR","NP","NL","NC","NZ","NI","NE","NG","NU","NF","MP","NO","OM","PK","PW","PS","PA","PG","PY","PE","PH","PN","PL","PT","PR","QA","MK","RO","RU","RW","RE","BL","SH","KN","LC","MF","PM","VC","WS","SM","ST","SA","SN","RS","SC","SL","SG","SX","SK","SI","SB","SO","ZA","GS","SS","ES","LK","SD","SR","SJ","SE","CH","SY","TW","TJ","TZ","TH","TL","TG","TK","TO","TT","TN","TR","TM","TC","TV","UG","UA","AE","GB","UM","US","UY","UZ","VU","VE","VN","VG","VI","WF","EH","YE","ZM","ZW","AX"],"example":"BR","uniqueKey":"owner.oneOf.0.identificationDocument.country","typeLabel":"enum\u003cstring>"}},"required":["value","type"],"isRequired":true,"uniqueKey":"owner.oneOf.0.identificationDocument","typeLabel":"object"},"industry":{"type":"string","description":"Industry classification of the company.","enum":["AGRICULTURE","AGRICULTURAL_FOOD_SUPPLY","ENERGY","ENERGY_OIL_GAS","RETAIL_GENERAL","ECOMMERCE_ONLINE_RETAIL","DISTRIBUTION_WHOLESALE","MOTOR_VEHICLE_RETAIL_PARTS","FIRST_HAND_CAR_RETAIL","SECOND_HAND_CAR_RETAIL","SPORTS_EQUIPMENT_RETAIL","TEXTILE_WHOLESALE","PRECIOUS_METALS_WHOLESALE","AIRCRAFT_AERONAUTIC_WHOLESALE","PRE_PRIMARY_PRIMARY_EDUCATION","SECONDARY_POST_SECONDARY_EDUCATION","HIGHER_EDUCATION","PRIVATE_EDUCATION_TRAINING_SERVICES","ARTS_MEDIA","VIDEO_TV_PRODUCTION","TELECOM_MEDIA","SPORTS_CLUBS_ASSOCIATIONS","SPORTS_COACHING","GAMING_EGAMING","PRODUCTION_CULTURAL_HANDMADE_GOODS","FASHION_PRODUCTION","PASSENGER_TRANSPORT","LEASING_TRANSPORT_EQUIPMENT","BANKING","INSURANCE","LENDING_CREDIT_SERVICES","INVESTMENT_ASSET_MANAGEMENT","FINANCIAL_SERVICES_NON_CRYPTO","PAYMENT_SERVICE_PROVIDERS","CRYPTO_EXCHANGE_CEX","WALLET_PROVIDER","CRYPTO_LIQUIDITY_MARKET_MAKERS","CRYPTO_MINING","WEB3_FINANCIAL_SERVICES","GAMBLING_CASINOS","ADULT_ENTERTAINMENT","MEDICAL_CARE_CLINICS","HEALTHCARE_SERVICES","MANUFACTURE_MEDICAL_SUPPLIES","PHARMACEUTICAL_MANUFACTURING","MEDICAL_PHARMACEUTICAL_SERVICES","DENTAL_CARE","VETERINARY_CARE","AERONAUTICS_AEROSPACE_MANUFACTURING","AUTOMOTIVE_MANUFACTURING","CONSTRUCTION_INFRASTRUCTURE","METAL_MANUFACTURING","WATER_GAS_PIPELINE_CONSTRUCTION","INDUSTRIAL_COMPANIES_GENERAL","PUBLIC_ADMINISTRATION","LOCAL_GOVERNMENT","PUBLIC_SERVICES_AUTHORITIES","NONPROFIT_CHARITY_ORGANIZATIONS","REAL_ESTATE_AGENCIES","REAL_ESTATE_DEVELOPERS","ONLINE_REAL_ESTATE_MARKETPLACES","INFORMATION_TECHNOLOGY_GENERAL","COMPUTER_HIGH_TECH_TELECOM","SOFTWARE_DEVELOPMENT","IT_INFRASTRUCTURE_FACILITIES_MANAGEMENT","COMPUTER_ELECTRONICS_REPAIR","CYBERSECURITY_INFORMATION_SECURITY","AUDIT_ACCOUNTING_TECHNOLOGY","TECHNOLOGY_CONSULTING","ENGINEERING_TECHNICAL_SERVICES","FREIGHT_LOGISTICS","TRANSPORTATION","HOTEL_HOSPITALITY","RESTAURANTS_CAFES","TOURISM","TRAVEL_AGENCIES","LEGAL_SERVICES","HUMAN_RESOURCES","CLEANING_MAINTENANCE_SERVICES","CULTURAL_GOODS_HANDICRAFTS_TRADE","FASHION_DESIGN","PRECIOUS_METALS_STONES","ENVIRONMENT_SUSTAINABILITY_SERVICES","ARMAMENT_DEFENSE_INDUSTRY","UNEMPLOYED_STUDENT_RETIRED","OTHERS"],"example":"SOFTWARE_DEVELOPMENT","isRequired":true,"uniqueKey":"owner.oneOf.0.industry","typeLabel":"enum\u003cstring>"},"expectedMonthlyVolume":{"type":"string","description":"Expected monthly transaction volume for the account owner, declared at onboarding for compliance review. Bucket bounds are expressed in the local currency of the owner; the bucket name reflects the inclusive lower bound and the inclusive upper bound (or `ABOVE_*` for the open-ended top bucket).","enum":["FROM_0_TO_50000","FROM_50001_TO_500000","FROM_500001_TO_5000000","FROM_5000001_TO_50000000","ABOVE_50000000"],"example":"FROM_0_TO_50000","isRequired":true,"uniqueKey":"owner.oneOf.0.expectedMonthlyVolume","typeLabel":"enum\u003cstring>"},"address":{"type":"object","properties":{"addressLine1":{"type":"string","example":"Rua das Flores, 100","isRequired":true,"uniqueKey":"owner.oneOf.0.address.addressLine1","typeLabel":"string"},"city":{"type":"string","example":"São Paulo","isRequired":true,"uniqueKey":"owner.oneOf.0.address.city","typeLabel":"string"},"country":{"type":"string","description":"ISO 3166-1 alpha-2 country code.","example":"BR","enum":["AF","AL","DZ","AS","AD","AO","AI","AQ","AG","AR","AM","AW","AU","AT","AZ","BS","BH","BD","BB","BY","BE","BZ","BJ","BM","BT","BO","BQ","BA","BW","BV","BR","IO","BN","BG","BF","BI","CV","KH","CM","CA","KY","CF","TD","CL","CN","CX","CC","CO","KM","CD","CG","CK","CR","HR","CU","CW","CY","CZ","CI","DK","DJ","DM","DO","EC","EG","SV","GQ","ER","EE","SZ","ET","FK","FO","FJ","FI","FR","GF","PF","TF","GA","GM","GE","DE","GH","GI","GR","GL","GD","GP","GU","GT","GG","GN","GW","GY","HT","HM","VA","HN","HK","HU","IS","IN","ID","IR","IQ","IE","IM","IL","IT","JM","JP","JE","JO","KZ","KE","KI","KP","KR","KW","KG","LA","LV","LB","LS","LR","LY","LI","LT","LU","MO","MG","MW","MY","MV","ML","MT","MH","MQ","MR","MU","YT","MX","FM","MD","MC","MN","ME","MS","MA","MZ","MM","NA","NR","NP","NL","NC","NZ","NI","NE","NG","NU","NF","MP","NO","OM","PK","PW","PS","PA","PG","PY","PE","PH","PN","PL","PT","PR","QA","MK","RO","RU","RW","RE","BL","SH","KN","LC","MF","PM","VC","WS","SM","ST","SA","SN","RS","SC","SL","SG","SX","SK","SI","SB","SO","ZA","GS","SS","ES","LK","SD","SR","SJ","SE","CH","SY","TW","TJ","TZ","TH","TL","TG","TK","TO","TT","TN","TR","TM","TC","TV","UG","UA","AE","GB","UM","US","UY","UZ","VU","VE","VN","VG","VI","WF","EH","YE","ZM","ZW","AX"],"isRequired":true,"uniqueKey":"owner.oneOf.0.address.country","typeLabel":"enum\u003cstring>"},"postalCode":{"type":"string","example":"01234-567","isRequired":true,"uniqueKey":"owner.oneOf.0.address.postalCode","typeLabel":"string"},"addressLine2":{"oneOf":[{"type":"string","example":"Suite 456","uniqueKey":"owner.oneOf.0.address.addressLine2.oneOf.0","typeLabel":"string"},{"type":"null","example":"Suite 456","uniqueKey":"owner.oneOf.0.address.addressLine2.oneOf.1","typeLabel":"null"}],"uniqueKey":"owner.oneOf.0.address.addressLine2","typeLabel":"string | null"},"state":{"oneOf":[{"type":"string","example":"SP","uniqueKey":"owner.oneOf.0.address.state.oneOf.0","typeLabel":"string"},{"type":"null","example":"SP","uniqueKey":"owner.oneOf.0.address.state.oneOf.1","typeLabel":"null"}],"uniqueKey":"owner.oneOf.0.address.state","typeLabel":"string | null"}},"required":["addressLine1","city","country","postalCode"],"isRequired":true,"uniqueKey":"owner.oneOf.0.address","typeLabel":"object"},"ubos":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","format":"uuid","example":"b2c3d4e5-f6a7-8901-bcde-f12345678901","readOnly":true,"isRequired":true,"uniqueKey":"owner.oneOf.0.ubos.items.[INDEX].id","typeLabel":"string\u003cuuid>"},"name":{"type":"string","example":"João Silva","isRequired":true,"uniqueKey":"owner.oneOf.0.ubos.items.[INDEX].name","typeLabel":"string"},"identificationDocument":{"type":"object","description":"Identification document of an owner or beneficial owner. Tax-id documents (for example `CNPJ`, `CPF`) are validated against the type-specific format rules, and their `type` implies the country, so `country` is omitted for them. Non-fiscal documents (`PASSPORT`) carry an explicit `country`.\n","properties":{"type":{"type":"string","description":"Type of identification document. Tax-id types are country-specific and the type itself implies the country (`CPF`/`CNPJ` are Brazilian, `CUIT`/`CUIL` are Argentine, `RUT_CL` is Chilean, etc.). The non-fiscal `PASSPORT` type carries no implied country, so a `country` must be supplied alongside it.\n","enum":["CPF","CNPJ","CUIT","CUIL","RUT_CL","RUT_UY","CI_UY","RUC","DNI_PE","NIT","CC","RFC","RUC_PY","CI_PY","NIPC","NIF_PT","CIF","NIF_ES","NIE","SIREN","SIRET","NIF_FR","PARTITA_IVA","CODICE_FISCALE","UST_IDNR","STEUER_ID","KVK","BSN","BCE","NN_BE","ORGANISATIONSNUMMER","PERSONNUMMER","ORGANISASJONSNUMMER","FODSELSNUMMER","UID_CH","AHV","VAT_GB","NIN","EIN","SSN","ITIN","BN_CA","SIN","ABN","TFN","USCC","CORPORATE_NUMBER_JP","MY_NUMBER","BRN_KR","RRN","GSTIN","PAN","INN_RU","COMPANY_NUMBER_IL","TEUDAT_ZEHUT","TRADE_LICENSE","EMIRATES_ID","CIPC","SA_ID","PASSPORT"],"example":"CNPJ","isRequired":true,"uniqueKey":"owner.oneOf.0.ubos.items.[INDEX].identificationDocument.type","typeLabel":"enum\u003cstring>"},"value":{"type":"string","description":"Document digits or alphanumeric value (depending on type).","example":"11222333000181","isRequired":true,"uniqueKey":"owner.oneOf.0.ubos.items.[INDEX].identificationDocument.value","typeLabel":"string"},"country":{"type":"string","description":"ISO 3166-1 alpha-2 country of the document. Present only for non-fiscal types such as `PASSPORT`; tax-id types derive it from `type`.\n","enum":["AF","AL","DZ","AS","AD","AO","AI","AQ","AG","AR","AM","AW","AU","AT","AZ","BS","BH","BD","BB","BY","BE","BZ","BJ","BM","BT","BO","BQ","BA","BW","BV","BR","IO","BN","BG","BF","BI","CV","KH","CM","CA","KY","CF","TD","CL","CN","CX","CC","CO","KM","CD","CG","CK","CR","HR","CU","CW","CY","CZ","CI","DK","DJ","DM","DO","EC","EG","SV","GQ","ER","EE","SZ","ET","FK","FO","FJ","FI","FR","GF","PF","TF","GA","GM","GE","DE","GH","GI","GR","GL","GD","GP","GU","GT","GG","GN","GW","GY","HT","HM","VA","HN","HK","HU","IS","IN","ID","IR","IQ","IE","IM","IL","IT","JM","JP","JE","JO","KZ","KE","KI","KP","KR","KW","KG","LA","LV","LB","LS","LR","LY","LI","LT","LU","MO","MG","MW","MY","MV","ML","MT","MH","MQ","MR","MU","YT","MX","FM","MD","MC","MN","ME","MS","MA","MZ","MM","NA","NR","NP","NL","NC","NZ","NI","NE","NG","NU","NF","MP","NO","OM","PK","PW","PS","PA","PG","PY","PE","PH","PN","PL","PT","PR","QA","MK","RO","RU","RW","RE","BL","SH","KN","LC","MF","PM","VC","WS","SM","ST","SA","SN","RS","SC","SL","SG","SX","SK","SI","SB","SO","ZA","GS","SS","ES","LK","SD","SR","SJ","SE","CH","SY","TW","TJ","TZ","TH","TL","TG","TK","TO","TT","TN","TR","TM","TC","TV","UG","UA","AE","GB","UM","US","UY","UZ","VU","VE","VN","VG","VI","WF","EH","YE","ZM","ZW","AX"],"example":"BR","uniqueKey":"owner.oneOf.0.ubos.items.[INDEX].identificationDocument.country","typeLabel":"enum\u003cstring>"}},"required":["value","type"],"isRequired":true,"uniqueKey":"owner.oneOf.0.ubos.items.[INDEX].identificationDocument","typeLabel":"object"},"address":{"type":"object","properties":{"addressLine1":{"type":"string","example":"Rua das Flores, 100","isRequired":true,"uniqueKey":"owner.oneOf.0.ubos.items.[INDEX].address.addressLine1","typeLabel":"string"},"city":{"type":"string","example":"São Paulo","isRequired":true,"uniqueKey":"owner.oneOf.0.ubos.items.[INDEX].address.city","typeLabel":"string"},"country":{"type":"string","description":"ISO 3166-1 alpha-2 country code.","example":"BR","enum":["AF","AL","DZ","AS","AD","AO","AI","AQ","AG","AR","AM","AW","AU","AT","AZ","BS","BH","BD","BB","BY","BE","BZ","BJ","BM","BT","BO","BQ","BA","BW","BV","BR","IO","BN","BG","BF","BI","CV","KH","CM","CA","KY","CF","TD","CL","CN","CX","CC","CO","KM","CD","CG","CK","CR","HR","CU","CW","CY","CZ","CI","DK","DJ","DM","DO","EC","EG","SV","GQ","ER","EE","SZ","ET","FK","FO","FJ","FI","FR","GF","PF","TF","GA","GM","GE","DE","GH","GI","GR","GL","GD","GP","GU","GT","GG","GN","GW","GY","HT","HM","VA","HN","HK","HU","IS","IN","ID","IR","IQ","IE","IM","IL","IT","JM","JP","JE","JO","KZ","KE","KI","KP","KR","KW","KG","LA","LV","LB","LS","LR","LY","LI","LT","LU","MO","MG","MW","MY","MV","ML","MT","MH","MQ","MR","MU","YT","MX","FM","MD","MC","MN","ME","MS","MA","MZ","MM","NA","NR","NP","NL","NC","NZ","NI","NE","NG","NU","NF","MP","NO","OM","PK","PW","PS","PA","PG","PY","PE","PH","PN","PL","PT","PR","QA","MK","RO","RU","RW","RE","BL","SH","KN","LC","MF","PM","VC","WS","SM","ST","SA","SN","RS","SC","SL","SG","SX","SK","SI","SB","SO","ZA","GS","SS","ES","LK","SD","SR","SJ","SE","CH","SY","TW","TJ","TZ","TH","TL","TG","TK","TO","TT","TN","TR","TM","TC","TV","UG","UA","AE","GB","UM","US","UY","UZ","VU","VE","VN","VG","VI","WF","EH","YE","ZM","ZW","AX"],"isRequired":true,"uniqueKey":"owner.oneOf.0.ubos.items.[INDEX].address.country","typeLabel":"enum\u003cstring>"},"postalCode":{"type":"string","example":"01234-567","isRequired":true,"uniqueKey":"owner.oneOf.0.ubos.items.[INDEX].address.postalCode","typeLabel":"string"},"addressLine2":{"oneOf":[{"type":"string","example":"Suite 456","uniqueKey":"owner.oneOf.0.ubos.items.[INDEX].address.addressLine2.oneOf.0","typeLabel":"string"},{"type":"null","example":"Suite 456","uniqueKey":"owner.oneOf.0.ubos.items.[INDEX].address.addressLine2.oneOf.1","typeLabel":"null"}],"uniqueKey":"owner.oneOf.0.ubos.items.[INDEX].address.addressLine2","typeLabel":"string | null"},"state":{"oneOf":[{"type":"string","example":"SP","uniqueKey":"owner.oneOf.0.ubos.items.[INDEX].address.state.oneOf.0","typeLabel":"string"},{"type":"null","example":"SP","uniqueKey":"owner.oneOf.0.ubos.items.[INDEX].address.state.oneOf.1","typeLabel":"null"}],"uniqueKey":"owner.oneOf.0.ubos.items.[INDEX].address.state","typeLabel":"string | null"}},"required":["addressLine1","city","country","postalCode"],"isRequired":true,"uniqueKey":"owner.oneOf.0.ubos.items.[INDEX].address","typeLabel":"object"},"phone":{"type":"string","example":"5511999999999","isRequired":true,"uniqueKey":"owner.oneOf.0.ubos.items.[INDEX].phone","typeLabel":"string"},"email":{"type":"string","format":"email","example":"joao.silva@example.com","isRequired":true,"uniqueKey":"owner.oneOf.0.ubos.items.[INDEX].email","typeLabel":"string\u003cemail>"},"isLegalRepresentative":{"type":"boolean","example":false,"isRequired":true,"uniqueKey":"owner.oneOf.0.ubos.items.[INDEX].isLegalRepresentative","typeLabel":"boolean"},"currentState":{"type":"object","description":"A point-in-time state of a beneficial owner.","properties":{"status":{"type":"string","enum":["PENDING","APPROVED","REJECTED"],"example":"PENDING","isRequired":true,"uniqueKey":"owner.oneOf.0.ubos.items.[INDEX].currentState.status","typeLabel":"enum\u003cstring>"},"createdAt":{"type":"string","format":"date-time","example":"2026-01-15T10:30:00Z","isRequired":true,"uniqueKey":"owner.oneOf.0.ubos.items.[INDEX].currentState.createdAt","typeLabel":"string\u003cdate-time>"},"reason":{"oneOf":[{"type":"object","description":"Explains why a state transition occurred.","properties":{"code":{"type":"string","description":"Machine-readable error code.","example":"DOCUMENT_REJECTED","isRequired":true,"uniqueKey":"owner.oneOf.0.ubos.items.[INDEX].currentState.reason.oneOf.0.code","typeLabel":"string"},"message":{"type":"string","description":"Human-readable description.","example":"Document is illegible","isRequired":true,"uniqueKey":"owner.oneOf.0.ubos.items.[INDEX].currentState.reason.oneOf.0.message","typeLabel":"string"},"details":{"type":"object","additionalProperties":true,"description":"Additional context. May be empty.","example":{},"isRequired":true,"uniqueKey":"owner.oneOf.0.ubos.items.[INDEX].currentState.reason.oneOf.0.details","typeLabel":"object"}},"required":["code","message","details"],"uniqueKey":"owner.oneOf.0.ubos.items.[INDEX].currentState.reason.oneOf.0","typeLabel":"object"},{"type":"null","description":"Explains why a state transition occurred.","properties":{"code":{"type":"string","description":"Machine-readable error code.","example":"DOCUMENT_REJECTED"},"message":{"type":"string","description":"Human-readable description.","example":"Document is illegible"},"details":{"type":"object","additionalProperties":true,"description":"Additional context. May be empty.","example":{}}},"required":["code","message","details"],"uniqueKey":"owner.oneOf.0.ubos.items.[INDEX].currentState.reason.oneOf.1","typeLabel":"null"}],"uniqueKey":"owner.oneOf.0.ubos.items.[INDEX].currentState.reason","typeLabel":"object | null"}},"required":["status","createdAt"],"isRequired":true,"uniqueKey":"owner.oneOf.0.ubos.items.[INDEX].currentState","typeLabel":"object"},"ownershipPercentage":{"oneOf":[{"type":"number","format":"double","example":50,"uniqueKey":"owner.oneOf.0.ubos.items.[INDEX].ownershipPercentage.oneOf.0","typeLabel":"number\u003cdouble>"},{"type":"null","format":"double","example":50,"uniqueKey":"owner.oneOf.0.ubos.items.[INDEX].ownershipPercentage.oneOf.1","typeLabel":"null"}],"uniqueKey":"owner.oneOf.0.ubos.items.[INDEX].ownershipPercentage","typeLabel":"number\u003cdouble> | null"}},"required":["id","name","identificationDocument","address","phone","email","isLegalRepresentative","currentState"],"uniqueKey":"owner.oneOf.0.ubos.items.[INDEX]","typeLabel":"object"},"isRequired":true,"uniqueKey":"owner.oneOf.0.ubos","typeLabel":"object[]"}},"isRequired":true,"uniqueKey":"owner.oneOf.0","typeLabel":"Company · object"},{"type":"object","title":"Individual","description":"The legal entity that owns the account. Discriminated by `type`.","required":["type","firstName","lastName","identificationDocument","expectedMonthlyVolume","address"],"properties":{"type":{"type":"string","enum":["INDIVIDUAL"],"isRequired":true,"uniqueKey":"owner.oneOf.1.type","typeLabel":"enum\u003cstring>"},"firstName":{"type":"string","example":"Maria","isRequired":true,"uniqueKey":"owner.oneOf.1.firstName","typeLabel":"string"},"lastName":{"type":"string","example":"Silva","isRequired":true,"uniqueKey":"owner.oneOf.1.lastName","typeLabel":"string"},"identificationDocument":{"type":"object","description":"Identification document of an owner or beneficial owner. Tax-id documents (for example `CNPJ`, `CPF`) are validated against the type-specific format rules, and their `type` implies the country, so `country` is omitted for them. Non-fiscal documents (`PASSPORT`) carry an explicit `country`.\n","properties":{"type":{"type":"string","description":"Type of identification document. Tax-id types are country-specific and the type itself implies the country (`CPF`/`CNPJ` are Brazilian, `CUIT`/`CUIL` are Argentine, `RUT_CL` is Chilean, etc.). The non-fiscal `PASSPORT` type carries no implied country, so a `country` must be supplied alongside it.\n","enum":["CPF","CNPJ","CUIT","CUIL","RUT_CL","RUT_UY","CI_UY","RUC","DNI_PE","NIT","CC","RFC","RUC_PY","CI_PY","NIPC","NIF_PT","CIF","NIF_ES","NIE","SIREN","SIRET","NIF_FR","PARTITA_IVA","CODICE_FISCALE","UST_IDNR","STEUER_ID","KVK","BSN","BCE","NN_BE","ORGANISATIONSNUMMER","PERSONNUMMER","ORGANISASJONSNUMMER","FODSELSNUMMER","UID_CH","AHV","VAT_GB","NIN","EIN","SSN","ITIN","BN_CA","SIN","ABN","TFN","USCC","CORPORATE_NUMBER_JP","MY_NUMBER","BRN_KR","RRN","GSTIN","PAN","INN_RU","COMPANY_NUMBER_IL","TEUDAT_ZEHUT","TRADE_LICENSE","EMIRATES_ID","CIPC","SA_ID","PASSPORT"],"example":"CNPJ","isRequired":true,"uniqueKey":"owner.oneOf.1.identificationDocument.type","typeLabel":"enum\u003cstring>"},"value":{"type":"string","description":"Document digits or alphanumeric value (depending on type).","example":"11222333000181","isRequired":true,"uniqueKey":"owner.oneOf.1.identificationDocument.value","typeLabel":"string"},"country":{"type":"string","description":"ISO 3166-1 alpha-2 country of the document. Present only for non-fiscal types such as `PASSPORT`; tax-id types derive it from `type`.\n","enum":["AF","AL","DZ","AS","AD","AO","AI","AQ","AG","AR","AM","AW","AU","AT","AZ","BS","BH","BD","BB","BY","BE","BZ","BJ","BM","BT","BO","BQ","BA","BW","BV","BR","IO","BN","BG","BF","BI","CV","KH","CM","CA","KY","CF","TD","CL","CN","CX","CC","CO","KM","CD","CG","CK","CR","HR","CU","CW","CY","CZ","CI","DK","DJ","DM","DO","EC","EG","SV","GQ","ER","EE","SZ","ET","FK","FO","FJ","FI","FR","GF","PF","TF","GA","GM","GE","DE","GH","GI","GR","GL","GD","GP","GU","GT","GG","GN","GW","GY","HT","HM","VA","HN","HK","HU","IS","IN","ID","IR","IQ","IE","IM","IL","IT","JM","JP","JE","JO","KZ","KE","KI","KP","KR","KW","KG","LA","LV","LB","LS","LR","LY","LI","LT","LU","MO","MG","MW","MY","MV","ML","MT","MH","MQ","MR","MU","YT","MX","FM","MD","MC","MN","ME","MS","MA","MZ","MM","NA","NR","NP","NL","NC","NZ","NI","NE","NG","NU","NF","MP","NO","OM","PK","PW","PS","PA","PG","PY","PE","PH","PN","PL","PT","PR","QA","MK","RO","RU","RW","RE","BL","SH","KN","LC","MF","PM","VC","WS","SM","ST","SA","SN","RS","SC","SL","SG","SX","SK","SI","SB","SO","ZA","GS","SS","ES","LK","SD","SR","SJ","SE","CH","SY","TW","TJ","TZ","TH","TL","TG","TK","TO","TT","TN","TR","TM","TC","TV","UG","UA","AE","GB","UM","US","UY","UZ","VU","VE","VN","VG","VI","WF","EH","YE","ZM","ZW","AX"],"example":"BR","uniqueKey":"owner.oneOf.1.identificationDocument.country","typeLabel":"enum\u003cstring>"}},"required":["value","type"],"isRequired":true,"uniqueKey":"owner.oneOf.1.identificationDocument","typeLabel":"object"},"expectedMonthlyVolume":{"type":"string","description":"Expected monthly transaction volume for the account owner, declared at onboarding for compliance review. Bucket bounds are expressed in the local currency of the owner; the bucket name reflects the inclusive lower bound and the inclusive upper bound (or `ABOVE_*` for the open-ended top bucket).","enum":["FROM_0_TO_50000","FROM_50001_TO_500000","FROM_500001_TO_5000000","FROM_5000001_TO_50000000","ABOVE_50000000"],"example":"FROM_0_TO_50000","isRequired":true,"uniqueKey":"owner.oneOf.1.expectedMonthlyVolume","typeLabel":"enum\u003cstring>"},"address":{"type":"object","properties":{"addressLine1":{"type":"string","example":"Rua das Flores, 100","isRequired":true,"uniqueKey":"owner.oneOf.1.address.addressLine1","typeLabel":"string"},"city":{"type":"string","example":"São Paulo","isRequired":true,"uniqueKey":"owner.oneOf.1.address.city","typeLabel":"string"},"country":{"type":"string","description":"ISO 3166-1 alpha-2 country code.","example":"BR","enum":["AF","AL","DZ","AS","AD","AO","AI","AQ","AG","AR","AM","AW","AU","AT","AZ","BS","BH","BD","BB","BY","BE","BZ","BJ","BM","BT","BO","BQ","BA","BW","BV","BR","IO","BN","BG","BF","BI","CV","KH","CM","CA","KY","CF","TD","CL","CN","CX","CC","CO","KM","CD","CG","CK","CR","HR","CU","CW","CY","CZ","CI","DK","DJ","DM","DO","EC","EG","SV","GQ","ER","EE","SZ","ET","FK","FO","FJ","FI","FR","GF","PF","TF","GA","GM","GE","DE","GH","GI","GR","GL","GD","GP","GU","GT","GG","GN","GW","GY","HT","HM","VA","HN","HK","HU","IS","IN","ID","IR","IQ","IE","IM","IL","IT","JM","JP","JE","JO","KZ","KE","KI","KP","KR","KW","KG","LA","LV","LB","LS","LR","LY","LI","LT","LU","MO","MG","MW","MY","MV","ML","MT","MH","MQ","MR","MU","YT","MX","FM","MD","MC","MN","ME","MS","MA","MZ","MM","NA","NR","NP","NL","NC","NZ","NI","NE","NG","NU","NF","MP","NO","OM","PK","PW","PS","PA","PG","PY","PE","PH","PN","PL","PT","PR","QA","MK","RO","RU","RW","RE","BL","SH","KN","LC","MF","PM","VC","WS","SM","ST","SA","SN","RS","SC","SL","SG","SX","SK","SI","SB","SO","ZA","GS","SS","ES","LK","SD","SR","SJ","SE","CH","SY","TW","TJ","TZ","TH","TL","TG","TK","TO","TT","TN","TR","TM","TC","TV","UG","UA","AE","GB","UM","US","UY","UZ","VU","VE","VN","VG","VI","WF","EH","YE","ZM","ZW","AX"],"isRequired":true,"uniqueKey":"owner.oneOf.1.address.country","typeLabel":"enum\u003cstring>"},"postalCode":{"type":"string","example":"01234-567","isRequired":true,"uniqueKey":"owner.oneOf.1.address.postalCode","typeLabel":"string"},"addressLine2":{"oneOf":[{"type":"string","example":"Suite 456","uniqueKey":"owner.oneOf.1.address.addressLine2.oneOf.0","typeLabel":"string"},{"type":"null","example":"Suite 456","uniqueKey":"owner.oneOf.1.address.addressLine2.oneOf.1","typeLabel":"null"}],"uniqueKey":"owner.oneOf.1.address.addressLine2","typeLabel":"string | null"},"state":{"oneOf":[{"type":"string","example":"SP","uniqueKey":"owner.oneOf.1.address.state.oneOf.0","typeLabel":"string"},{"type":"null","example":"SP","uniqueKey":"owner.oneOf.1.address.state.oneOf.1","typeLabel":"null"}],"uniqueKey":"owner.oneOf.1.address.state","typeLabel":"string | null"}},"required":["addressLine1","city","country","postalCode"],"isRequired":true,"uniqueKey":"owner.oneOf.1.address","typeLabel":"object"}},"isRequired":true,"uniqueKey":"owner.oneOf.1","typeLabel":"Individual · object"}],"isRequired":true,"uniqueKey":"owner","typeLabel":"Company · object | Individual · object"},"assets":{"type":"array","description":"Assets enabled on the account, with the onboarding status of the underlying provider account.","items":{"type":"object","description":"An asset available on the account and the onboarding status of its underlying provider account.","properties":{"currency":{"type":"string","enum":["BRL","USDT","USDC"],"description":"ISO 4217 currency code or stablecoin ticker. The maximum decimal scale of an `AmountValue` paired with this asset depends on the asset:\n\n| Asset | Decimals |\n|---|---|\n| BRL | 2 |\n| USDT | 6 |\n| USDC | 6 |\n","example":"BRL","isRequired":true,"uniqueKey":"assets.items.[INDEX].currency","typeLabel":"enum\u003cstring>"},"allowsVirtualAccounts":{"type":"boolean","description":"Whether virtual accounts can be issued for this asset.","example":false,"isRequired":true,"uniqueKey":"assets.items.[INDEX].allowsVirtualAccounts","typeLabel":"boolean"},"status":{"type":"string","description":"Onboarding status of the provider account that custodies this asset.","enum":["ONBOARDING","ACTIVE","FAILED","FROZEN","DEACTIVATED"],"example":"ONBOARDING","readOnly":true,"isRequired":true,"uniqueKey":"assets.items.[INDEX].status","typeLabel":"enum\u003cstring>"}},"required":["currency","allowsVirtualAccounts","status"],"uniqueKey":"assets.items.[INDEX]","typeLabel":"object"},"isRequired":true,"uniqueKey":"assets","typeLabel":"object[]"},"requirements":{"type":"object","description":"Requirement buckets grouped by lifecycle stage.","properties":{"currentlyDue":{"type":"array","description":"Requirements pending submission.","items":{"oneOf":[{"type":"object","title":"Account document","description":"A single requirement. The `type` field discriminates between six shapes:\n\n- `ACCOUNT_DOCUMENT`: a specific document is required at the account level.\n- `UBO_DOCUMENT`: a specific document is required for a beneficial owner.\n- `IDENTITY_VERIFICATION`: any one document from `options` satisfies an identity verification requirement.\n- `INCORPORATION_DOCUMENT`: any one document from `options` satisfies an incorporation requirement.\n- `ACCOUNT_FIELD`: an account-level field was rejected during review.\n- `UBO_FIELD`: a UBO field was rejected during review.\n","required":["documentType","type"],"properties":{"type":{"type":"string","enum":["ACCOUNT_DOCUMENT"],"isRequired":true,"uniqueKey":"requirements.currentlyDue.items.[INDEX].oneOf.0.type","typeLabel":"enum\u003cstring>"},"documentType":{"type":"string","description":"Type of document.","enum":["PASSPORT","ARTICLES_OF_ASSOCIATION","OTHER","AGREEMENT","DIRECTORS_REGISTRY","INCORPORATION_ARTICLES","INCORPORATION_CERT","PROOF_OF_ADDRESS","SHAREHOLDER_REGISTRY","POWER_OF_ATTORNEY","STATE_REGISTRY","EVIDENCE_OF_SOURCE_OF_FUNDS","EVIDENCE_OF_SOURCE_OF_WEALTH","PROOF_OF_REGULATORY_LICENSE","PROOF_OF_BUSINESS_ACTIVITY","FUND_FLOW_EXPLANATION","AML_POLICY","FINANCIAL_STATEMENT","ORGANIZATIONAL_CHART","SHAREHOLDER_OWNERSHIP","WOLFSBERG_QUESTIONNAIRE","ID_CARD","DRIVER_LICENSE","RESIDENCE_PERMIT","SELFIE","UTILITY_BILL","KYC_FORM","BAAS_ADHESION_FORM","PJ_PARTNER_DOCUMENTS","PJ_PARTNER_FINANCIAL_STATEMENT","SIGNING_AUTHORITY_PROOF","KYC_MONITORING_EVIDENCE"],"example":"ARTICLES_OF_ASSOCIATION","isRequired":true,"uniqueKey":"requirements.currentlyDue.items.[INDEX].oneOf.0.documentType","typeLabel":"enum\u003cstring>"},"documentSubType":{"oneOf":[{"type":"string","description":"Sub-classification of the document. Set when the `documentType` requires a specific side (e.g., `FRONT_SIDE` for `ID_CARD`).\n","enum":["FRONT_SIDE","BACK_SIDE"],"example":"FRONT_SIDE","uniqueKey":"requirements.currentlyDue.items.[INDEX].oneOf.0.documentSubType.oneOf.0","typeLabel":"enum\u003cstring>"},{"type":"null","description":"Sub-classification of the document. Set when the `documentType` requires a specific side (e.g., `FRONT_SIDE` for `ID_CARD`).\n","uniqueKey":"requirements.currentlyDue.items.[INDEX].oneOf.0.documentSubType.oneOf.1","typeLabel":"null"}],"uniqueKey":"requirements.currentlyDue.items.[INDEX].oneOf.0.documentSubType","typeLabel":"enum\u003cstring> | null"},"requiredMetadata":{"oneOf":[{"type":"array","description":"Metadata keys that must accompany the document upload (e.g., `country`, `number`).","items":{"type":"string","uniqueKey":"requirements.currentlyDue.items.[INDEX].oneOf.0.requiredMetadata.oneOf.0.items.[INDEX]","typeLabel":"string"},"example":["country"],"uniqueKey":"requirements.currentlyDue.items.[INDEX].oneOf.0.requiredMetadata.oneOf.0","typeLabel":"string[]"},{"type":"null","description":"Metadata keys that must accompany the document upload (e.g., `country`, `number`).","items":{"type":"string"},"example":["country"],"uniqueKey":"requirements.currentlyDue.items.[INDEX].oneOf.0.requiredMetadata.oneOf.1","typeLabel":"null"}],"uniqueKey":"requirements.currentlyDue.items.[INDEX].oneOf.0.requiredMetadata","typeLabel":"string[] | null"},"metadata":{"oneOf":[{"type":"object","additionalProperties":{"type":"string","uniqueKey":"requirements.currentlyDue.items.[INDEX].oneOf.0.metadata.oneOf.0.additionalProperties","typeLabel":"string"},"description":"Metadata captured for an already-fulfilled requirement.","uniqueKey":"requirements.currentlyDue.items.[INDEX].oneOf.0.metadata.oneOf.0","typeLabel":"object"},{"type":"null","additionalProperties":{"type":"string","uniqueKey":"requirements.currentlyDue.items.[INDEX].oneOf.0.metadata.oneOf.1.additionalProperties","typeLabel":"string"},"description":"Metadata captured for an already-fulfilled requirement.","uniqueKey":"requirements.currentlyDue.items.[INDEX].oneOf.0.metadata.oneOf.1","typeLabel":"null"}],"uniqueKey":"requirements.currentlyDue.items.[INDEX].oneOf.0.metadata","typeLabel":"object | null"},"reason":{"oneOf":[{"type":"object","description":"Explains why a state transition occurred.","properties":{"code":{"type":"string","description":"Machine-readable error code.","example":"DOCUMENT_REJECTED","isRequired":true,"uniqueKey":"requirements.currentlyDue.items.[INDEX].oneOf.0.reason.oneOf.0.code","typeLabel":"string"},"message":{"type":"string","description":"Human-readable description.","example":"Document is illegible","isRequired":true,"uniqueKey":"requirements.currentlyDue.items.[INDEX].oneOf.0.reason.oneOf.0.message","typeLabel":"string"},"details":{"type":"object","additionalProperties":true,"description":"Additional context. May be empty.","example":{},"isRequired":true,"uniqueKey":"requirements.currentlyDue.items.[INDEX].oneOf.0.reason.oneOf.0.details","typeLabel":"object"}},"required":["code","message","details"],"uniqueKey":"requirements.currentlyDue.items.[INDEX].oneOf.0.reason.oneOf.0","typeLabel":"object"},{"type":"null","description":"Explains why a state transition occurred.","properties":{"code":{"type":"string","description":"Machine-readable error code.","example":"DOCUMENT_REJECTED"},"message":{"type":"string","description":"Human-readable description.","example":"Document is illegible"},"details":{"type":"object","additionalProperties":true,"description":"Additional context. May be empty.","example":{}}},"required":["code","message","details"],"uniqueKey":"requirements.currentlyDue.items.[INDEX].oneOf.0.reason.oneOf.1","typeLabel":"null"}],"uniqueKey":"requirements.currentlyDue.items.[INDEX].oneOf.0.reason","typeLabel":"object | null"}},"uniqueKey":"requirements.currentlyDue.items.[INDEX].oneOf.0","typeLabel":"Account document · object"},{"type":"object","title":"UBO document","description":"A single requirement. The `type` field discriminates between six shapes:\n\n- `ACCOUNT_DOCUMENT`: a specific document is required at the account level.\n- `UBO_DOCUMENT`: a specific document is required for a beneficial owner.\n- `IDENTITY_VERIFICATION`: any one document from `options` satisfies an identity verification requirement.\n- `INCORPORATION_DOCUMENT`: any one document from `options` satisfies an incorporation requirement.\n- `ACCOUNT_FIELD`: an account-level field was rejected during review.\n- `UBO_FIELD`: a UBO field was rejected during review.\n","required":["documentType","type","uboId"],"properties":{"type":{"type":"string","enum":["UBO_DOCUMENT"],"isRequired":true,"uniqueKey":"requirements.currentlyDue.items.[INDEX].oneOf.1.type","typeLabel":"enum\u003cstring>"},"uboId":{"type":"string","format":"uuid","description":"Identifier of the beneficial owner this document belongs to.","example":"a1b2c3d4-e5f6-7890-1234-567890abcdef","isRequired":true,"uniqueKey":"requirements.currentlyDue.items.[INDEX].oneOf.1.uboId","typeLabel":"string\u003cuuid>"},"documentType":{"type":"string","description":"Type of document.","enum":["PASSPORT","ARTICLES_OF_ASSOCIATION","OTHER","AGREEMENT","DIRECTORS_REGISTRY","INCORPORATION_ARTICLES","INCORPORATION_CERT","PROOF_OF_ADDRESS","SHAREHOLDER_REGISTRY","POWER_OF_ATTORNEY","STATE_REGISTRY","EVIDENCE_OF_SOURCE_OF_FUNDS","EVIDENCE_OF_SOURCE_OF_WEALTH","PROOF_OF_REGULATORY_LICENSE","PROOF_OF_BUSINESS_ACTIVITY","FUND_FLOW_EXPLANATION","AML_POLICY","FINANCIAL_STATEMENT","ORGANIZATIONAL_CHART","SHAREHOLDER_OWNERSHIP","WOLFSBERG_QUESTIONNAIRE","ID_CARD","DRIVER_LICENSE","RESIDENCE_PERMIT","SELFIE","UTILITY_BILL","KYC_FORM","BAAS_ADHESION_FORM","PJ_PARTNER_DOCUMENTS","PJ_PARTNER_FINANCIAL_STATEMENT","SIGNING_AUTHORITY_PROOF","KYC_MONITORING_EVIDENCE"],"example":"ARTICLES_OF_ASSOCIATION","isRequired":true,"uniqueKey":"requirements.currentlyDue.items.[INDEX].oneOf.1.documentType","typeLabel":"enum\u003cstring>"},"documentSubType":{"oneOf":[{"type":"string","description":"Sub-classification of the document. Set when the `documentType` requires a specific side (e.g., `FRONT_SIDE` for `ID_CARD`).\n","enum":["FRONT_SIDE","BACK_SIDE"],"example":"FRONT_SIDE","uniqueKey":"requirements.currentlyDue.items.[INDEX].oneOf.1.documentSubType.oneOf.0","typeLabel":"enum\u003cstring>"},{"type":"null","description":"Sub-classification of the document. Set when the `documentType` requires a specific side (e.g., `FRONT_SIDE` for `ID_CARD`).\n","uniqueKey":"requirements.currentlyDue.items.[INDEX].oneOf.1.documentSubType.oneOf.1","typeLabel":"null"}],"uniqueKey":"requirements.currentlyDue.items.[INDEX].oneOf.1.documentSubType","typeLabel":"enum\u003cstring> | null"},"requiredMetadata":{"oneOf":[{"type":"array","description":"Metadata keys that must accompany the document upload (e.g., `country`, `number`).","items":{"type":"string","uniqueKey":"requirements.currentlyDue.items.[INDEX].oneOf.1.requiredMetadata.oneOf.0.items.[INDEX]","typeLabel":"string"},"example":["country"],"uniqueKey":"requirements.currentlyDue.items.[INDEX].oneOf.1.requiredMetadata.oneOf.0","typeLabel":"string[]"},{"type":"null","description":"Metadata keys that must accompany the document upload (e.g., `country`, `number`).","items":{"type":"string"},"example":["country"],"uniqueKey":"requirements.currentlyDue.items.[INDEX].oneOf.1.requiredMetadata.oneOf.1","typeLabel":"null"}],"uniqueKey":"requirements.currentlyDue.items.[INDEX].oneOf.1.requiredMetadata","typeLabel":"string[] | null"},"metadata":{"oneOf":[{"type":"object","additionalProperties":{"type":"string","uniqueKey":"requirements.currentlyDue.items.[INDEX].oneOf.1.metadata.oneOf.0.additionalProperties","typeLabel":"string"},"description":"Metadata captured for an already-fulfilled requirement.","uniqueKey":"requirements.currentlyDue.items.[INDEX].oneOf.1.metadata.oneOf.0","typeLabel":"object"},{"type":"null","additionalProperties":{"type":"string","uniqueKey":"requirements.currentlyDue.items.[INDEX].oneOf.1.metadata.oneOf.1.additionalProperties","typeLabel":"string"},"description":"Metadata captured for an already-fulfilled requirement.","uniqueKey":"requirements.currentlyDue.items.[INDEX].oneOf.1.metadata.oneOf.1","typeLabel":"null"}],"uniqueKey":"requirements.currentlyDue.items.[INDEX].oneOf.1.metadata","typeLabel":"object | null"},"reason":{"oneOf":[{"type":"object","description":"Explains why a state transition occurred.","properties":{"code":{"type":"string","description":"Machine-readable error code.","example":"DOCUMENT_REJECTED","isRequired":true,"uniqueKey":"requirements.currentlyDue.items.[INDEX].oneOf.1.reason.oneOf.0.code","typeLabel":"string"},"message":{"type":"string","description":"Human-readable description.","example":"Document is illegible","isRequired":true,"uniqueKey":"requirements.currentlyDue.items.[INDEX].oneOf.1.reason.oneOf.0.message","typeLabel":"string"},"details":{"type":"object","additionalProperties":true,"description":"Additional context. May be empty.","example":{},"isRequired":true,"uniqueKey":"requirements.currentlyDue.items.[INDEX].oneOf.1.reason.oneOf.0.details","typeLabel":"object"}},"required":["code","message","details"],"uniqueKey":"requirements.currentlyDue.items.[INDEX].oneOf.1.reason.oneOf.0","typeLabel":"object"},{"type":"null","description":"Explains why a state transition occurred.","properties":{"code":{"type":"string","description":"Machine-readable error code.","example":"DOCUMENT_REJECTED"},"message":{"type":"string","description":"Human-readable description.","example":"Document is illegible"},"details":{"type":"object","additionalProperties":true,"description":"Additional context. May be empty.","example":{}}},"required":["code","message","details"],"uniqueKey":"requirements.currentlyDue.items.[INDEX].oneOf.1.reason.oneOf.1","typeLabel":"null"}],"uniqueKey":"requirements.currentlyDue.items.[INDEX].oneOf.1.reason","typeLabel":"object | null"}},"uniqueKey":"requirements.currentlyDue.items.[INDEX].oneOf.1","typeLabel":"UBO document · object"},{"type":"object","title":"Identity verification","description":"A single requirement. The `type` field discriminates between six shapes:\n\n- `ACCOUNT_DOCUMENT`: a specific document is required at the account level.\n- `UBO_DOCUMENT`: a specific document is required for a beneficial owner.\n- `IDENTITY_VERIFICATION`: any one document from `options` satisfies an identity verification requirement.\n- `INCORPORATION_DOCUMENT`: any one document from `options` satisfies an incorporation requirement.\n- `ACCOUNT_FIELD`: an account-level field was rejected during review.\n- `UBO_FIELD`: a UBO field was rejected during review.\n","required":["options","type"],"properties":{"type":{"type":"string","enum":["IDENTITY_VERIFICATION"],"isRequired":true,"uniqueKey":"requirements.currentlyDue.items.[INDEX].oneOf.2.type","typeLabel":"enum\u003cstring>"},"options":{"type":"array","description":"Acceptable document options that satisfy this requirement.","items":{"type":"object","description":"One acceptable document type within a grouped requirement, together with the sub-types and metadata keys the client must supply when uploading that type. `subTypes` and `requiredMetadata` are omitted when empty.\n","properties":{"documentType":{"type":"string","description":"Type of document.","enum":["PASSPORT","ARTICLES_OF_ASSOCIATION","OTHER","AGREEMENT","DIRECTORS_REGISTRY","INCORPORATION_ARTICLES","INCORPORATION_CERT","PROOF_OF_ADDRESS","SHAREHOLDER_REGISTRY","POWER_OF_ATTORNEY","STATE_REGISTRY","EVIDENCE_OF_SOURCE_OF_FUNDS","EVIDENCE_OF_SOURCE_OF_WEALTH","PROOF_OF_REGULATORY_LICENSE","PROOF_OF_BUSINESS_ACTIVITY","FUND_FLOW_EXPLANATION","AML_POLICY","FINANCIAL_STATEMENT","ORGANIZATIONAL_CHART","SHAREHOLDER_OWNERSHIP","WOLFSBERG_QUESTIONNAIRE","ID_CARD","DRIVER_LICENSE","RESIDENCE_PERMIT","SELFIE","UTILITY_BILL","KYC_FORM","BAAS_ADHESION_FORM","PJ_PARTNER_DOCUMENTS","PJ_PARTNER_FINANCIAL_STATEMENT","SIGNING_AUTHORITY_PROOF","KYC_MONITORING_EVIDENCE"],"example":"ARTICLES_OF_ASSOCIATION","isRequired":true,"uniqueKey":"requirements.currentlyDue.items.[INDEX].oneOf.2.options.items.[INDEX].documentType","typeLabel":"enum\u003cstring>"},"subTypes":{"type":"array","description":"Sub-classifications required for this document type (e.g., `FRONT_SIDE` and `BACK_SIDE` for `ID_CARD`). Omitted when the document type has no sub-types.","items":{"type":"string","description":"Sub-classification for documents that have multiple sides.","enum":["FRONT_SIDE","BACK_SIDE"],"example":"FRONT_SIDE","uniqueKey":"requirements.currentlyDue.items.[INDEX].oneOf.2.options.items.[INDEX].subTypes.items.[INDEX]","typeLabel":"enum\u003cstring>"},"uniqueKey":"requirements.currentlyDue.items.[INDEX].oneOf.2.options.items.[INDEX].subTypes","typeLabel":"enum\u003cstring>[]"},"requiredMetadata":{"type":"array","description":"Metadata keys that must accompany the upload of this document type (e.g., `country`, `number`). Omitted when no metadata is required.","items":{"type":"string","uniqueKey":"requirements.currentlyDue.items.[INDEX].oneOf.2.options.items.[INDEX].requiredMetadata.items.[INDEX]","typeLabel":"string"},"example":["country"],"uniqueKey":"requirements.currentlyDue.items.[INDEX].oneOf.2.options.items.[INDEX].requiredMetadata","typeLabel":"string[]"}},"required":["documentType"],"uniqueKey":"requirements.currentlyDue.items.[INDEX].oneOf.2.options.items.[INDEX]","typeLabel":"object"},"isRequired":true,"uniqueKey":"requirements.currentlyDue.items.[INDEX].oneOf.2.options","typeLabel":"object[]"},"uboId":{"oneOf":[{"type":"string","format":"uuid","description":"Identifier of the beneficial owner this requirement belongs to. Omitted for account-level requirements.","example":"a1b2c3d4-e5f6-7890-1234-567890abcdef","uniqueKey":"requirements.currentlyDue.items.[INDEX].oneOf.2.uboId.oneOf.0","typeLabel":"string\u003cuuid>"},{"type":"null","format":"uuid","description":"Identifier of the beneficial owner this requirement belongs to. Omitted for account-level requirements.","example":"a1b2c3d4-e5f6-7890-1234-567890abcdef","uniqueKey":"requirements.currentlyDue.items.[INDEX].oneOf.2.uboId.oneOf.1","typeLabel":"null"}],"uniqueKey":"requirements.currentlyDue.items.[INDEX].oneOf.2.uboId","typeLabel":"string\u003cuuid> | null"}},"uniqueKey":"requirements.currentlyDue.items.[INDEX].oneOf.2","typeLabel":"Identity verification · object"},{"type":"object","title":"Incorporation document","description":"A single requirement. The `type` field discriminates between six shapes:\n\n- `ACCOUNT_DOCUMENT`: a specific document is required at the account level.\n- `UBO_DOCUMENT`: a specific document is required for a beneficial owner.\n- `IDENTITY_VERIFICATION`: any one document from `options` satisfies an identity verification requirement.\n- `INCORPORATION_DOCUMENT`: any one document from `options` satisfies an incorporation requirement.\n- `ACCOUNT_FIELD`: an account-level field was rejected during review.\n- `UBO_FIELD`: a UBO field was rejected during review.\n","required":["options","type"],"properties":{"type":{"type":"string","enum":["INCORPORATION_DOCUMENT"],"isRequired":true,"uniqueKey":"requirements.currentlyDue.items.[INDEX].oneOf.3.type","typeLabel":"enum\u003cstring>"},"options":{"type":"array","description":"Acceptable document options that satisfy this requirement.","items":{"type":"object","description":"One acceptable document type within a grouped requirement, together with the sub-types and metadata keys the client must supply when uploading that type. `subTypes` and `requiredMetadata` are omitted when empty.\n","properties":{"documentType":{"type":"string","description":"Type of document.","enum":["PASSPORT","ARTICLES_OF_ASSOCIATION","OTHER","AGREEMENT","DIRECTORS_REGISTRY","INCORPORATION_ARTICLES","INCORPORATION_CERT","PROOF_OF_ADDRESS","SHAREHOLDER_REGISTRY","POWER_OF_ATTORNEY","STATE_REGISTRY","EVIDENCE_OF_SOURCE_OF_FUNDS","EVIDENCE_OF_SOURCE_OF_WEALTH","PROOF_OF_REGULATORY_LICENSE","PROOF_OF_BUSINESS_ACTIVITY","FUND_FLOW_EXPLANATION","AML_POLICY","FINANCIAL_STATEMENT","ORGANIZATIONAL_CHART","SHAREHOLDER_OWNERSHIP","WOLFSBERG_QUESTIONNAIRE","ID_CARD","DRIVER_LICENSE","RESIDENCE_PERMIT","SELFIE","UTILITY_BILL","KYC_FORM","BAAS_ADHESION_FORM","PJ_PARTNER_DOCUMENTS","PJ_PARTNER_FINANCIAL_STATEMENT","SIGNING_AUTHORITY_PROOF","KYC_MONITORING_EVIDENCE"],"example":"ARTICLES_OF_ASSOCIATION","isRequired":true,"uniqueKey":"requirements.currentlyDue.items.[INDEX].oneOf.3.options.items.[INDEX].documentType","typeLabel":"enum\u003cstring>"},"subTypes":{"type":"array","description":"Sub-classifications required for this document type (e.g., `FRONT_SIDE` and `BACK_SIDE` for `ID_CARD`). Omitted when the document type has no sub-types.","items":{"type":"string","description":"Sub-classification for documents that have multiple sides.","enum":["FRONT_SIDE","BACK_SIDE"],"example":"FRONT_SIDE","uniqueKey":"requirements.currentlyDue.items.[INDEX].oneOf.3.options.items.[INDEX].subTypes.items.[INDEX]","typeLabel":"enum\u003cstring>"},"uniqueKey":"requirements.currentlyDue.items.[INDEX].oneOf.3.options.items.[INDEX].subTypes","typeLabel":"enum\u003cstring>[]"},"requiredMetadata":{"type":"array","description":"Metadata keys that must accompany the upload of this document type (e.g., `country`, `number`). Omitted when no metadata is required.","items":{"type":"string","uniqueKey":"requirements.currentlyDue.items.[INDEX].oneOf.3.options.items.[INDEX].requiredMetadata.items.[INDEX]","typeLabel":"string"},"example":["country"],"uniqueKey":"requirements.currentlyDue.items.[INDEX].oneOf.3.options.items.[INDEX].requiredMetadata","typeLabel":"string[]"}},"required":["documentType"],"uniqueKey":"requirements.currentlyDue.items.[INDEX].oneOf.3.options.items.[INDEX]","typeLabel":"object"},"isRequired":true,"uniqueKey":"requirements.currentlyDue.items.[INDEX].oneOf.3.options","typeLabel":"object[]"},"uboId":{"oneOf":[{"type":"string","format":"uuid","description":"Identifier of the beneficial owner this requirement belongs to. Omitted for account-level requirements.","example":"a1b2c3d4-e5f6-7890-1234-567890abcdef","uniqueKey":"requirements.currentlyDue.items.[INDEX].oneOf.3.uboId.oneOf.0","typeLabel":"string\u003cuuid>"},{"type":"null","format":"uuid","description":"Identifier of the beneficial owner this requirement belongs to. Omitted for account-level requirements.","example":"a1b2c3d4-e5f6-7890-1234-567890abcdef","uniqueKey":"requirements.currentlyDue.items.[INDEX].oneOf.3.uboId.oneOf.1","typeLabel":"null"}],"uniqueKey":"requirements.currentlyDue.items.[INDEX].oneOf.3.uboId","typeLabel":"string\u003cuuid> | null"}},"uniqueKey":"requirements.currentlyDue.items.[INDEX].oneOf.3","typeLabel":"Incorporation document · object"},{"type":"object","title":"Account field rejection","description":"A single requirement. The `type` field discriminates between six shapes:\n\n- `ACCOUNT_DOCUMENT`: a specific document is required at the account level.\n- `UBO_DOCUMENT`: a specific document is required for a beneficial owner.\n- `IDENTITY_VERIFICATION`: any one document from `options` satisfies an identity verification requirement.\n- `INCORPORATION_DOCUMENT`: any one document from `options` satisfies an incorporation requirement.\n- `ACCOUNT_FIELD`: an account-level field was rejected during review.\n- `UBO_FIELD`: a UBO field was rejected during review.\n","required":["type","fieldName","reason"],"properties":{"type":{"type":"string","enum":["ACCOUNT_FIELD"],"isRequired":true,"uniqueKey":"requirements.currentlyDue.items.[INDEX].oneOf.4.type","typeLabel":"enum\u003cstring>"},"fieldName":{"type":"string","description":"Name of the rejected field.","example":"owner.legalName","isRequired":true,"uniqueKey":"requirements.currentlyDue.items.[INDEX].oneOf.4.fieldName","typeLabel":"string"},"reason":{"oneOf":[{"type":"object","description":"Explains why a state transition occurred.","properties":{"code":{"type":"string","description":"Machine-readable error code.","example":"DOCUMENT_REJECTED","isRequired":true,"uniqueKey":"requirements.currentlyDue.items.[INDEX].oneOf.4.reason.oneOf.0.code","typeLabel":"string"},"message":{"type":"string","description":"Human-readable description.","example":"Document is illegible","isRequired":true,"uniqueKey":"requirements.currentlyDue.items.[INDEX].oneOf.4.reason.oneOf.0.message","typeLabel":"string"},"details":{"type":"object","additionalProperties":true,"description":"Additional context. May be empty.","example":{},"isRequired":true,"uniqueKey":"requirements.currentlyDue.items.[INDEX].oneOf.4.reason.oneOf.0.details","typeLabel":"object"}},"required":["code","message","details"],"isRequired":true,"uniqueKey":"requirements.currentlyDue.items.[INDEX].oneOf.4.reason.oneOf.0","typeLabel":"object"},{"type":"null","description":"Explains why a state transition occurred.","properties":{"code":{"type":"string","description":"Machine-readable error code.","example":"DOCUMENT_REJECTED"},"message":{"type":"string","description":"Human-readable description.","example":"Document is illegible"},"details":{"type":"object","additionalProperties":true,"description":"Additional context. May be empty.","example":{}}},"required":["code","message","details"],"isRequired":true,"uniqueKey":"requirements.currentlyDue.items.[INDEX].oneOf.4.reason.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"requirements.currentlyDue.items.[INDEX].oneOf.4.reason","typeLabel":"object | null"}},"uniqueKey":"requirements.currentlyDue.items.[INDEX].oneOf.4","typeLabel":"Account field rejection · object"},{"type":"object","title":"UBO field rejection","description":"A single requirement. The `type` field discriminates between six shapes:\n\n- `ACCOUNT_DOCUMENT`: a specific document is required at the account level.\n- `UBO_DOCUMENT`: a specific document is required for a beneficial owner.\n- `IDENTITY_VERIFICATION`: any one document from `options` satisfies an identity verification requirement.\n- `INCORPORATION_DOCUMENT`: any one document from `options` satisfies an incorporation requirement.\n- `ACCOUNT_FIELD`: an account-level field was rejected during review.\n- `UBO_FIELD`: a UBO field was rejected during review.\n","required":["type","fieldName","uboId","reason"],"properties":{"type":{"type":"string","enum":["UBO_FIELD"],"isRequired":true,"uniqueKey":"requirements.currentlyDue.items.[INDEX].oneOf.5.type","typeLabel":"enum\u003cstring>"},"fieldName":{"type":"string","description":"Name of the rejected field.","example":"name","isRequired":true,"uniqueKey":"requirements.currentlyDue.items.[INDEX].oneOf.5.fieldName","typeLabel":"string"},"uboId":{"type":"string","description":"Identifier of the beneficial owner whose field was rejected.","example":"a1b2c3d4-e5f6-7890-1234-567890abcdef","isRequired":true,"uniqueKey":"requirements.currentlyDue.items.[INDEX].oneOf.5.uboId","typeLabel":"string"},"reason":{"oneOf":[{"type":"object","description":"Explains why a state transition occurred.","properties":{"code":{"type":"string","description":"Machine-readable error code.","example":"DOCUMENT_REJECTED","isRequired":true,"uniqueKey":"requirements.currentlyDue.items.[INDEX].oneOf.5.reason.oneOf.0.code","typeLabel":"string"},"message":{"type":"string","description":"Human-readable description.","example":"Document is illegible","isRequired":true,"uniqueKey":"requirements.currentlyDue.items.[INDEX].oneOf.5.reason.oneOf.0.message","typeLabel":"string"},"details":{"type":"object","additionalProperties":true,"description":"Additional context. May be empty.","example":{},"isRequired":true,"uniqueKey":"requirements.currentlyDue.items.[INDEX].oneOf.5.reason.oneOf.0.details","typeLabel":"object"}},"required":["code","message","details"],"isRequired":true,"uniqueKey":"requirements.currentlyDue.items.[INDEX].oneOf.5.reason.oneOf.0","typeLabel":"object"},{"type":"null","description":"Explains why a state transition occurred.","properties":{"code":{"type":"string","description":"Machine-readable error code.","example":"DOCUMENT_REJECTED"},"message":{"type":"string","description":"Human-readable description.","example":"Document is illegible"},"details":{"type":"object","additionalProperties":true,"description":"Additional context. May be empty.","example":{}}},"required":["code","message","details"],"isRequired":true,"uniqueKey":"requirements.currentlyDue.items.[INDEX].oneOf.5.reason.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"requirements.currentlyDue.items.[INDEX].oneOf.5.reason","typeLabel":"object | null"}},"uniqueKey":"requirements.currentlyDue.items.[INDEX].oneOf.5","typeLabel":"UBO field rejection · object"}],"uniqueKey":"requirements.currentlyDue.items.[INDEX]","typeLabel":"Account document · object | UBO document · object | Identity verification · object | Incorporation document · object | Account field rejection · object | UBO field rejection · object"},"isRequired":true,"uniqueKey":"requirements.currentlyDue","typeLabel":"(Account document · object | UBO document · object | Identity verification · object | Incorporation document · object | Account field rejection · object | UBO field rejection · object)[]"},"pendingVerification":{"type":"array","description":"Submitted requirements awaiting verification.","items":{"oneOf":[{"type":"object","title":"Account document","description":"A single requirement. The `type` field discriminates between six shapes:\n\n- `ACCOUNT_DOCUMENT`: a specific document is required at the account level.\n- `UBO_DOCUMENT`: a specific document is required for a beneficial owner.\n- `IDENTITY_VERIFICATION`: any one document from `options` satisfies an identity verification requirement.\n- `INCORPORATION_DOCUMENT`: any one document from `options` satisfies an incorporation requirement.\n- `ACCOUNT_FIELD`: an account-level field was rejected during review.\n- `UBO_FIELD`: a UBO field was rejected during review.\n","required":["documentType","type"],"properties":{"type":{"type":"string","enum":["ACCOUNT_DOCUMENT"],"isRequired":true,"uniqueKey":"requirements.pendingVerification.items.[INDEX].oneOf.0.type","typeLabel":"enum\u003cstring>"},"documentType":{"type":"string","description":"Type of document.","enum":["PASSPORT","ARTICLES_OF_ASSOCIATION","OTHER","AGREEMENT","DIRECTORS_REGISTRY","INCORPORATION_ARTICLES","INCORPORATION_CERT","PROOF_OF_ADDRESS","SHAREHOLDER_REGISTRY","POWER_OF_ATTORNEY","STATE_REGISTRY","EVIDENCE_OF_SOURCE_OF_FUNDS","EVIDENCE_OF_SOURCE_OF_WEALTH","PROOF_OF_REGULATORY_LICENSE","PROOF_OF_BUSINESS_ACTIVITY","FUND_FLOW_EXPLANATION","AML_POLICY","FINANCIAL_STATEMENT","ORGANIZATIONAL_CHART","SHAREHOLDER_OWNERSHIP","WOLFSBERG_QUESTIONNAIRE","ID_CARD","DRIVER_LICENSE","RESIDENCE_PERMIT","SELFIE","UTILITY_BILL","KYC_FORM","BAAS_ADHESION_FORM","PJ_PARTNER_DOCUMENTS","PJ_PARTNER_FINANCIAL_STATEMENT","SIGNING_AUTHORITY_PROOF","KYC_MONITORING_EVIDENCE"],"example":"ARTICLES_OF_ASSOCIATION","isRequired":true,"uniqueKey":"requirements.pendingVerification.items.[INDEX].oneOf.0.documentType","typeLabel":"enum\u003cstring>"},"documentSubType":{"oneOf":[{"type":"string","description":"Sub-classification of the document. Set when the `documentType` requires a specific side (e.g., `FRONT_SIDE` for `ID_CARD`).\n","enum":["FRONT_SIDE","BACK_SIDE"],"example":"FRONT_SIDE","uniqueKey":"requirements.pendingVerification.items.[INDEX].oneOf.0.documentSubType.oneOf.0","typeLabel":"enum\u003cstring>"},{"type":"null","description":"Sub-classification of the document. Set when the `documentType` requires a specific side (e.g., `FRONT_SIDE` for `ID_CARD`).\n","uniqueKey":"requirements.pendingVerification.items.[INDEX].oneOf.0.documentSubType.oneOf.1","typeLabel":"null"}],"uniqueKey":"requirements.pendingVerification.items.[INDEX].oneOf.0.documentSubType","typeLabel":"enum\u003cstring> | null"},"requiredMetadata":{"oneOf":[{"type":"array","description":"Metadata keys that must accompany the document upload (e.g., `country`, `number`).","items":{"type":"string","uniqueKey":"requirements.pendingVerification.items.[INDEX].oneOf.0.requiredMetadata.oneOf.0.items.[INDEX]","typeLabel":"string"},"example":["country"],"uniqueKey":"requirements.pendingVerification.items.[INDEX].oneOf.0.requiredMetadata.oneOf.0","typeLabel":"string[]"},{"type":"null","description":"Metadata keys that must accompany the document upload (e.g., `country`, `number`).","items":{"type":"string"},"example":["country"],"uniqueKey":"requirements.pendingVerification.items.[INDEX].oneOf.0.requiredMetadata.oneOf.1","typeLabel":"null"}],"uniqueKey":"requirements.pendingVerification.items.[INDEX].oneOf.0.requiredMetadata","typeLabel":"string[] | null"},"metadata":{"oneOf":[{"type":"object","additionalProperties":{"type":"string","uniqueKey":"requirements.pendingVerification.items.[INDEX].oneOf.0.metadata.oneOf.0.additionalProperties","typeLabel":"string"},"description":"Metadata captured for an already-fulfilled requirement.","uniqueKey":"requirements.pendingVerification.items.[INDEX].oneOf.0.metadata.oneOf.0","typeLabel":"object"},{"type":"null","additionalProperties":{"type":"string","uniqueKey":"requirements.pendingVerification.items.[INDEX].oneOf.0.metadata.oneOf.1.additionalProperties","typeLabel":"string"},"description":"Metadata captured for an already-fulfilled requirement.","uniqueKey":"requirements.pendingVerification.items.[INDEX].oneOf.0.metadata.oneOf.1","typeLabel":"null"}],"uniqueKey":"requirements.pendingVerification.items.[INDEX].oneOf.0.metadata","typeLabel":"object | null"},"reason":{"oneOf":[{"type":"object","description":"Explains why a state transition occurred.","properties":{"code":{"type":"string","description":"Machine-readable error code.","example":"DOCUMENT_REJECTED","isRequired":true,"uniqueKey":"requirements.pendingVerification.items.[INDEX].oneOf.0.reason.oneOf.0.code","typeLabel":"string"},"message":{"type":"string","description":"Human-readable description.","example":"Document is illegible","isRequired":true,"uniqueKey":"requirements.pendingVerification.items.[INDEX].oneOf.0.reason.oneOf.0.message","typeLabel":"string"},"details":{"type":"object","additionalProperties":true,"description":"Additional context. May be empty.","example":{},"isRequired":true,"uniqueKey":"requirements.pendingVerification.items.[INDEX].oneOf.0.reason.oneOf.0.details","typeLabel":"object"}},"required":["code","message","details"],"uniqueKey":"requirements.pendingVerification.items.[INDEX].oneOf.0.reason.oneOf.0","typeLabel":"object"},{"type":"null","description":"Explains why a state transition occurred.","properties":{"code":{"type":"string","description":"Machine-readable error code.","example":"DOCUMENT_REJECTED"},"message":{"type":"string","description":"Human-readable description.","example":"Document is illegible"},"details":{"type":"object","additionalProperties":true,"description":"Additional context. May be empty.","example":{}}},"required":["code","message","details"],"uniqueKey":"requirements.pendingVerification.items.[INDEX].oneOf.0.reason.oneOf.1","typeLabel":"null"}],"uniqueKey":"requirements.pendingVerification.items.[INDEX].oneOf.0.reason","typeLabel":"object | null"}},"uniqueKey":"requirements.pendingVerification.items.[INDEX].oneOf.0","typeLabel":"Account document · object"},{"type":"object","title":"UBO document","description":"A single requirement. The `type` field discriminates between six shapes:\n\n- `ACCOUNT_DOCUMENT`: a specific document is required at the account level.\n- `UBO_DOCUMENT`: a specific document is required for a beneficial owner.\n- `IDENTITY_VERIFICATION`: any one document from `options` satisfies an identity verification requirement.\n- `INCORPORATION_DOCUMENT`: any one document from `options` satisfies an incorporation requirement.\n- `ACCOUNT_FIELD`: an account-level field was rejected during review.\n- `UBO_FIELD`: a UBO field was rejected during review.\n","required":["documentType","type","uboId"],"properties":{"type":{"type":"string","enum":["UBO_DOCUMENT"],"isRequired":true,"uniqueKey":"requirements.pendingVerification.items.[INDEX].oneOf.1.type","typeLabel":"enum\u003cstring>"},"uboId":{"type":"string","format":"uuid","description":"Identifier of the beneficial owner this document belongs to.","example":"a1b2c3d4-e5f6-7890-1234-567890abcdef","isRequired":true,"uniqueKey":"requirements.pendingVerification.items.[INDEX].oneOf.1.uboId","typeLabel":"string\u003cuuid>"},"documentType":{"type":"string","description":"Type of document.","enum":["PASSPORT","ARTICLES_OF_ASSOCIATION","OTHER","AGREEMENT","DIRECTORS_REGISTRY","INCORPORATION_ARTICLES","INCORPORATION_CERT","PROOF_OF_ADDRESS","SHAREHOLDER_REGISTRY","POWER_OF_ATTORNEY","STATE_REGISTRY","EVIDENCE_OF_SOURCE_OF_FUNDS","EVIDENCE_OF_SOURCE_OF_WEALTH","PROOF_OF_REGULATORY_LICENSE","PROOF_OF_BUSINESS_ACTIVITY","FUND_FLOW_EXPLANATION","AML_POLICY","FINANCIAL_STATEMENT","ORGANIZATIONAL_CHART","SHAREHOLDER_OWNERSHIP","WOLFSBERG_QUESTIONNAIRE","ID_CARD","DRIVER_LICENSE","RESIDENCE_PERMIT","SELFIE","UTILITY_BILL","KYC_FORM","BAAS_ADHESION_FORM","PJ_PARTNER_DOCUMENTS","PJ_PARTNER_FINANCIAL_STATEMENT","SIGNING_AUTHORITY_PROOF","KYC_MONITORING_EVIDENCE"],"example":"ARTICLES_OF_ASSOCIATION","isRequired":true,"uniqueKey":"requirements.pendingVerification.items.[INDEX].oneOf.1.documentType","typeLabel":"enum\u003cstring>"},"documentSubType":{"oneOf":[{"type":"string","description":"Sub-classification of the document. Set when the `documentType` requires a specific side (e.g., `FRONT_SIDE` for `ID_CARD`).\n","enum":["FRONT_SIDE","BACK_SIDE"],"example":"FRONT_SIDE","uniqueKey":"requirements.pendingVerification.items.[INDEX].oneOf.1.documentSubType.oneOf.0","typeLabel":"enum\u003cstring>"},{"type":"null","description":"Sub-classification of the document. Set when the `documentType` requires a specific side (e.g., `FRONT_SIDE` for `ID_CARD`).\n","uniqueKey":"requirements.pendingVerification.items.[INDEX].oneOf.1.documentSubType.oneOf.1","typeLabel":"null"}],"uniqueKey":"requirements.pendingVerification.items.[INDEX].oneOf.1.documentSubType","typeLabel":"enum\u003cstring> | null"},"requiredMetadata":{"oneOf":[{"type":"array","description":"Metadata keys that must accompany the document upload (e.g., `country`, `number`).","items":{"type":"string","uniqueKey":"requirements.pendingVerification.items.[INDEX].oneOf.1.requiredMetadata.oneOf.0.items.[INDEX]","typeLabel":"string"},"example":["country"],"uniqueKey":"requirements.pendingVerification.items.[INDEX].oneOf.1.requiredMetadata.oneOf.0","typeLabel":"string[]"},{"type":"null","description":"Metadata keys that must accompany the document upload (e.g., `country`, `number`).","items":{"type":"string"},"example":["country"],"uniqueKey":"requirements.pendingVerification.items.[INDEX].oneOf.1.requiredMetadata.oneOf.1","typeLabel":"null"}],"uniqueKey":"requirements.pendingVerification.items.[INDEX].oneOf.1.requiredMetadata","typeLabel":"string[] | null"},"metadata":{"oneOf":[{"type":"object","additionalProperties":{"type":"string","uniqueKey":"requirements.pendingVerification.items.[INDEX].oneOf.1.metadata.oneOf.0.additionalProperties","typeLabel":"string"},"description":"Metadata captured for an already-fulfilled requirement.","uniqueKey":"requirements.pendingVerification.items.[INDEX].oneOf.1.metadata.oneOf.0","typeLabel":"object"},{"type":"null","additionalProperties":{"type":"string","uniqueKey":"requirements.pendingVerification.items.[INDEX].oneOf.1.metadata.oneOf.1.additionalProperties","typeLabel":"string"},"description":"Metadata captured for an already-fulfilled requirement.","uniqueKey":"requirements.pendingVerification.items.[INDEX].oneOf.1.metadata.oneOf.1","typeLabel":"null"}],"uniqueKey":"requirements.pendingVerification.items.[INDEX].oneOf.1.metadata","typeLabel":"object | null"},"reason":{"oneOf":[{"type":"object","description":"Explains why a state transition occurred.","properties":{"code":{"type":"string","description":"Machine-readable error code.","example":"DOCUMENT_REJECTED","isRequired":true,"uniqueKey":"requirements.pendingVerification.items.[INDEX].oneOf.1.reason.oneOf.0.code","typeLabel":"string"},"message":{"type":"string","description":"Human-readable description.","example":"Document is illegible","isRequired":true,"uniqueKey":"requirements.pendingVerification.items.[INDEX].oneOf.1.reason.oneOf.0.message","typeLabel":"string"},"details":{"type":"object","additionalProperties":true,"description":"Additional context. May be empty.","example":{},"isRequired":true,"uniqueKey":"requirements.pendingVerification.items.[INDEX].oneOf.1.reason.oneOf.0.details","typeLabel":"object"}},"required":["code","message","details"],"uniqueKey":"requirements.pendingVerification.items.[INDEX].oneOf.1.reason.oneOf.0","typeLabel":"object"},{"type":"null","description":"Explains why a state transition occurred.","properties":{"code":{"type":"string","description":"Machine-readable error code.","example":"DOCUMENT_REJECTED"},"message":{"type":"string","description":"Human-readable description.","example":"Document is illegible"},"details":{"type":"object","additionalProperties":true,"description":"Additional context. May be empty.","example":{}}},"required":["code","message","details"],"uniqueKey":"requirements.pendingVerification.items.[INDEX].oneOf.1.reason.oneOf.1","typeLabel":"null"}],"uniqueKey":"requirements.pendingVerification.items.[INDEX].oneOf.1.reason","typeLabel":"object | null"}},"uniqueKey":"requirements.pendingVerification.items.[INDEX].oneOf.1","typeLabel":"UBO document · object"},{"type":"object","title":"Identity verification","description":"A single requirement. The `type` field discriminates between six shapes:\n\n- `ACCOUNT_DOCUMENT`: a specific document is required at the account level.\n- `UBO_DOCUMENT`: a specific document is required for a beneficial owner.\n- `IDENTITY_VERIFICATION`: any one document from `options` satisfies an identity verification requirement.\n- `INCORPORATION_DOCUMENT`: any one document from `options` satisfies an incorporation requirement.\n- `ACCOUNT_FIELD`: an account-level field was rejected during review.\n- `UBO_FIELD`: a UBO field was rejected during review.\n","required":["options","type"],"properties":{"type":{"type":"string","enum":["IDENTITY_VERIFICATION"],"isRequired":true,"uniqueKey":"requirements.pendingVerification.items.[INDEX].oneOf.2.type","typeLabel":"enum\u003cstring>"},"options":{"type":"array","description":"Acceptable document options that satisfy this requirement.","items":{"type":"object","description":"One acceptable document type within a grouped requirement, together with the sub-types and metadata keys the client must supply when uploading that type. `subTypes` and `requiredMetadata` are omitted when empty.\n","properties":{"documentType":{"type":"string","description":"Type of document.","enum":["PASSPORT","ARTICLES_OF_ASSOCIATION","OTHER","AGREEMENT","DIRECTORS_REGISTRY","INCORPORATION_ARTICLES","INCORPORATION_CERT","PROOF_OF_ADDRESS","SHAREHOLDER_REGISTRY","POWER_OF_ATTORNEY","STATE_REGISTRY","EVIDENCE_OF_SOURCE_OF_FUNDS","EVIDENCE_OF_SOURCE_OF_WEALTH","PROOF_OF_REGULATORY_LICENSE","PROOF_OF_BUSINESS_ACTIVITY","FUND_FLOW_EXPLANATION","AML_POLICY","FINANCIAL_STATEMENT","ORGANIZATIONAL_CHART","SHAREHOLDER_OWNERSHIP","WOLFSBERG_QUESTIONNAIRE","ID_CARD","DRIVER_LICENSE","RESIDENCE_PERMIT","SELFIE","UTILITY_BILL","KYC_FORM","BAAS_ADHESION_FORM","PJ_PARTNER_DOCUMENTS","PJ_PARTNER_FINANCIAL_STATEMENT","SIGNING_AUTHORITY_PROOF","KYC_MONITORING_EVIDENCE"],"example":"ARTICLES_OF_ASSOCIATION","isRequired":true,"uniqueKey":"requirements.pendingVerification.items.[INDEX].oneOf.2.options.items.[INDEX].documentType","typeLabel":"enum\u003cstring>"},"subTypes":{"type":"array","description":"Sub-classifications required for this document type (e.g., `FRONT_SIDE` and `BACK_SIDE` for `ID_CARD`). Omitted when the document type has no sub-types.","items":{"type":"string","description":"Sub-classification for documents that have multiple sides.","enum":["FRONT_SIDE","BACK_SIDE"],"example":"FRONT_SIDE","uniqueKey":"requirements.pendingVerification.items.[INDEX].oneOf.2.options.items.[INDEX].subTypes.items.[INDEX]","typeLabel":"enum\u003cstring>"},"uniqueKey":"requirements.pendingVerification.items.[INDEX].oneOf.2.options.items.[INDEX].subTypes","typeLabel":"enum\u003cstring>[]"},"requiredMetadata":{"type":"array","description":"Metadata keys that must accompany the upload of this document type (e.g., `country`, `number`). Omitted when no metadata is required.","items":{"type":"string","uniqueKey":"requirements.pendingVerification.items.[INDEX].oneOf.2.options.items.[INDEX].requiredMetadata.items.[INDEX]","typeLabel":"string"},"example":["country"],"uniqueKey":"requirements.pendingVerification.items.[INDEX].oneOf.2.options.items.[INDEX].requiredMetadata","typeLabel":"string[]"}},"required":["documentType"],"uniqueKey":"requirements.pendingVerification.items.[INDEX].oneOf.2.options.items.[INDEX]","typeLabel":"object"},"isRequired":true,"uniqueKey":"requirements.pendingVerification.items.[INDEX].oneOf.2.options","typeLabel":"object[]"},"uboId":{"oneOf":[{"type":"string","format":"uuid","description":"Identifier of the beneficial owner this requirement belongs to. Omitted for account-level requirements.","example":"a1b2c3d4-e5f6-7890-1234-567890abcdef","uniqueKey":"requirements.pendingVerification.items.[INDEX].oneOf.2.uboId.oneOf.0","typeLabel":"string\u003cuuid>"},{"type":"null","format":"uuid","description":"Identifier of the beneficial owner this requirement belongs to. Omitted for account-level requirements.","example":"a1b2c3d4-e5f6-7890-1234-567890abcdef","uniqueKey":"requirements.pendingVerification.items.[INDEX].oneOf.2.uboId.oneOf.1","typeLabel":"null"}],"uniqueKey":"requirements.pendingVerification.items.[INDEX].oneOf.2.uboId","typeLabel":"string\u003cuuid> | null"}},"uniqueKey":"requirements.pendingVerification.items.[INDEX].oneOf.2","typeLabel":"Identity verification · object"},{"type":"object","title":"Incorporation document","description":"A single requirement. The `type` field discriminates between six shapes:\n\n- `ACCOUNT_DOCUMENT`: a specific document is required at the account level.\n- `UBO_DOCUMENT`: a specific document is required for a beneficial owner.\n- `IDENTITY_VERIFICATION`: any one document from `options` satisfies an identity verification requirement.\n- `INCORPORATION_DOCUMENT`: any one document from `options` satisfies an incorporation requirement.\n- `ACCOUNT_FIELD`: an account-level field was rejected during review.\n- `UBO_FIELD`: a UBO field was rejected during review.\n","required":["options","type"],"properties":{"type":{"type":"string","enum":["INCORPORATION_DOCUMENT"],"isRequired":true,"uniqueKey":"requirements.pendingVerification.items.[INDEX].oneOf.3.type","typeLabel":"enum\u003cstring>"},"options":{"type":"array","description":"Acceptable document options that satisfy this requirement.","items":{"type":"object","description":"One acceptable document type within a grouped requirement, together with the sub-types and metadata keys the client must supply when uploading that type. `subTypes` and `requiredMetadata` are omitted when empty.\n","properties":{"documentType":{"type":"string","description":"Type of document.","enum":["PASSPORT","ARTICLES_OF_ASSOCIATION","OTHER","AGREEMENT","DIRECTORS_REGISTRY","INCORPORATION_ARTICLES","INCORPORATION_CERT","PROOF_OF_ADDRESS","SHAREHOLDER_REGISTRY","POWER_OF_ATTORNEY","STATE_REGISTRY","EVIDENCE_OF_SOURCE_OF_FUNDS","EVIDENCE_OF_SOURCE_OF_WEALTH","PROOF_OF_REGULATORY_LICENSE","PROOF_OF_BUSINESS_ACTIVITY","FUND_FLOW_EXPLANATION","AML_POLICY","FINANCIAL_STATEMENT","ORGANIZATIONAL_CHART","SHAREHOLDER_OWNERSHIP","WOLFSBERG_QUESTIONNAIRE","ID_CARD","DRIVER_LICENSE","RESIDENCE_PERMIT","SELFIE","UTILITY_BILL","KYC_FORM","BAAS_ADHESION_FORM","PJ_PARTNER_DOCUMENTS","PJ_PARTNER_FINANCIAL_STATEMENT","SIGNING_AUTHORITY_PROOF","KYC_MONITORING_EVIDENCE"],"example":"ARTICLES_OF_ASSOCIATION","isRequired":true,"uniqueKey":"requirements.pendingVerification.items.[INDEX].oneOf.3.options.items.[INDEX].documentType","typeLabel":"enum\u003cstring>"},"subTypes":{"type":"array","description":"Sub-classifications required for this document type (e.g., `FRONT_SIDE` and `BACK_SIDE` for `ID_CARD`). Omitted when the document type has no sub-types.","items":{"type":"string","description":"Sub-classification for documents that have multiple sides.","enum":["FRONT_SIDE","BACK_SIDE"],"example":"FRONT_SIDE","uniqueKey":"requirements.pendingVerification.items.[INDEX].oneOf.3.options.items.[INDEX].subTypes.items.[INDEX]","typeLabel":"enum\u003cstring>"},"uniqueKey":"requirements.pendingVerification.items.[INDEX].oneOf.3.options.items.[INDEX].subTypes","typeLabel":"enum\u003cstring>[]"},"requiredMetadata":{"type":"array","description":"Metadata keys that must accompany the upload of this document type (e.g., `country`, `number`). Omitted when no metadata is required.","items":{"type":"string","uniqueKey":"requirements.pendingVerification.items.[INDEX].oneOf.3.options.items.[INDEX].requiredMetadata.items.[INDEX]","typeLabel":"string"},"example":["country"],"uniqueKey":"requirements.pendingVerification.items.[INDEX].oneOf.3.options.items.[INDEX].requiredMetadata","typeLabel":"string[]"}},"required":["documentType"],"uniqueKey":"requirements.pendingVerification.items.[INDEX].oneOf.3.options.items.[INDEX]","typeLabel":"object"},"isRequired":true,"uniqueKey":"requirements.pendingVerification.items.[INDEX].oneOf.3.options","typeLabel":"object[]"},"uboId":{"oneOf":[{"type":"string","format":"uuid","description":"Identifier of the beneficial owner this requirement belongs to. Omitted for account-level requirements.","example":"a1b2c3d4-e5f6-7890-1234-567890abcdef","uniqueKey":"requirements.pendingVerification.items.[INDEX].oneOf.3.uboId.oneOf.0","typeLabel":"string\u003cuuid>"},{"type":"null","format":"uuid","description":"Identifier of the beneficial owner this requirement belongs to. Omitted for account-level requirements.","example":"a1b2c3d4-e5f6-7890-1234-567890abcdef","uniqueKey":"requirements.pendingVerification.items.[INDEX].oneOf.3.uboId.oneOf.1","typeLabel":"null"}],"uniqueKey":"requirements.pendingVerification.items.[INDEX].oneOf.3.uboId","typeLabel":"string\u003cuuid> | null"}},"uniqueKey":"requirements.pendingVerification.items.[INDEX].oneOf.3","typeLabel":"Incorporation document · object"},{"type":"object","title":"Account field rejection","description":"A single requirement. The `type` field discriminates between six shapes:\n\n- `ACCOUNT_DOCUMENT`: a specific document is required at the account level.\n- `UBO_DOCUMENT`: a specific document is required for a beneficial owner.\n- `IDENTITY_VERIFICATION`: any one document from `options` satisfies an identity verification requirement.\n- `INCORPORATION_DOCUMENT`: any one document from `options` satisfies an incorporation requirement.\n- `ACCOUNT_FIELD`: an account-level field was rejected during review.\n- `UBO_FIELD`: a UBO field was rejected during review.\n","required":["type","fieldName","reason"],"properties":{"type":{"type":"string","enum":["ACCOUNT_FIELD"],"isRequired":true,"uniqueKey":"requirements.pendingVerification.items.[INDEX].oneOf.4.type","typeLabel":"enum\u003cstring>"},"fieldName":{"type":"string","description":"Name of the rejected field.","example":"owner.legalName","isRequired":true,"uniqueKey":"requirements.pendingVerification.items.[INDEX].oneOf.4.fieldName","typeLabel":"string"},"reason":{"oneOf":[{"type":"object","description":"Explains why a state transition occurred.","properties":{"code":{"type":"string","description":"Machine-readable error code.","example":"DOCUMENT_REJECTED","isRequired":true,"uniqueKey":"requirements.pendingVerification.items.[INDEX].oneOf.4.reason.oneOf.0.code","typeLabel":"string"},"message":{"type":"string","description":"Human-readable description.","example":"Document is illegible","isRequired":true,"uniqueKey":"requirements.pendingVerification.items.[INDEX].oneOf.4.reason.oneOf.0.message","typeLabel":"string"},"details":{"type":"object","additionalProperties":true,"description":"Additional context. May be empty.","example":{},"isRequired":true,"uniqueKey":"requirements.pendingVerification.items.[INDEX].oneOf.4.reason.oneOf.0.details","typeLabel":"object"}},"required":["code","message","details"],"isRequired":true,"uniqueKey":"requirements.pendingVerification.items.[INDEX].oneOf.4.reason.oneOf.0","typeLabel":"object"},{"type":"null","description":"Explains why a state transition occurred.","properties":{"code":{"type":"string","description":"Machine-readable error code.","example":"DOCUMENT_REJECTED"},"message":{"type":"string","description":"Human-readable description.","example":"Document is illegible"},"details":{"type":"object","additionalProperties":true,"description":"Additional context. May be empty.","example":{}}},"required":["code","message","details"],"isRequired":true,"uniqueKey":"requirements.pendingVerification.items.[INDEX].oneOf.4.reason.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"requirements.pendingVerification.items.[INDEX].oneOf.4.reason","typeLabel":"object | null"}},"uniqueKey":"requirements.pendingVerification.items.[INDEX].oneOf.4","typeLabel":"Account field rejection · object"},{"type":"object","title":"UBO field rejection","description":"A single requirement. The `type` field discriminates between six shapes:\n\n- `ACCOUNT_DOCUMENT`: a specific document is required at the account level.\n- `UBO_DOCUMENT`: a specific document is required for a beneficial owner.\n- `IDENTITY_VERIFICATION`: any one document from `options` satisfies an identity verification requirement.\n- `INCORPORATION_DOCUMENT`: any one document from `options` satisfies an incorporation requirement.\n- `ACCOUNT_FIELD`: an account-level field was rejected during review.\n- `UBO_FIELD`: a UBO field was rejected during review.\n","required":["type","fieldName","uboId","reason"],"properties":{"type":{"type":"string","enum":["UBO_FIELD"],"isRequired":true,"uniqueKey":"requirements.pendingVerification.items.[INDEX].oneOf.5.type","typeLabel":"enum\u003cstring>"},"fieldName":{"type":"string","description":"Name of the rejected field.","example":"name","isRequired":true,"uniqueKey":"requirements.pendingVerification.items.[INDEX].oneOf.5.fieldName","typeLabel":"string"},"uboId":{"type":"string","description":"Identifier of the beneficial owner whose field was rejected.","example":"a1b2c3d4-e5f6-7890-1234-567890abcdef","isRequired":true,"uniqueKey":"requirements.pendingVerification.items.[INDEX].oneOf.5.uboId","typeLabel":"string"},"reason":{"oneOf":[{"type":"object","description":"Explains why a state transition occurred.","properties":{"code":{"type":"string","description":"Machine-readable error code.","example":"DOCUMENT_REJECTED","isRequired":true,"uniqueKey":"requirements.pendingVerification.items.[INDEX].oneOf.5.reason.oneOf.0.code","typeLabel":"string"},"message":{"type":"string","description":"Human-readable description.","example":"Document is illegible","isRequired":true,"uniqueKey":"requirements.pendingVerification.items.[INDEX].oneOf.5.reason.oneOf.0.message","typeLabel":"string"},"details":{"type":"object","additionalProperties":true,"description":"Additional context. May be empty.","example":{},"isRequired":true,"uniqueKey":"requirements.pendingVerification.items.[INDEX].oneOf.5.reason.oneOf.0.details","typeLabel":"object"}},"required":["code","message","details"],"isRequired":true,"uniqueKey":"requirements.pendingVerification.items.[INDEX].oneOf.5.reason.oneOf.0","typeLabel":"object"},{"type":"null","description":"Explains why a state transition occurred.","properties":{"code":{"type":"string","description":"Machine-readable error code.","example":"DOCUMENT_REJECTED"},"message":{"type":"string","description":"Human-readable description.","example":"Document is illegible"},"details":{"type":"object","additionalProperties":true,"description":"Additional context. May be empty.","example":{}}},"required":["code","message","details"],"isRequired":true,"uniqueKey":"requirements.pendingVerification.items.[INDEX].oneOf.5.reason.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"requirements.pendingVerification.items.[INDEX].oneOf.5.reason","typeLabel":"object | null"}},"uniqueKey":"requirements.pendingVerification.items.[INDEX].oneOf.5","typeLabel":"UBO field rejection · object"}],"uniqueKey":"requirements.pendingVerification.items.[INDEX]","typeLabel":"Account document · object | UBO document · object | Identity verification · object | Incorporation document · object | Account field rejection · object | UBO field rejection · object"},"isRequired":true,"uniqueKey":"requirements.pendingVerification","typeLabel":"(Account document · object | UBO document · object | Identity verification · object | Incorporation document · object | Account field rejection · object | UBO field rejection · object)[]"},"errors":{"type":"array","description":"Rejected requirements with reasons.","items":{"oneOf":[{"type":"object","title":"Account document","description":"A single requirement. The `type` field discriminates between six shapes:\n\n- `ACCOUNT_DOCUMENT`: a specific document is required at the account level.\n- `UBO_DOCUMENT`: a specific document is required for a beneficial owner.\n- `IDENTITY_VERIFICATION`: any one document from `options` satisfies an identity verification requirement.\n- `INCORPORATION_DOCUMENT`: any one document from `options` satisfies an incorporation requirement.\n- `ACCOUNT_FIELD`: an account-level field was rejected during review.\n- `UBO_FIELD`: a UBO field was rejected during review.\n","required":["documentType","type"],"properties":{"type":{"type":"string","enum":["ACCOUNT_DOCUMENT"],"isRequired":true,"uniqueKey":"requirements.errors.items.[INDEX].oneOf.0.type","typeLabel":"enum\u003cstring>"},"documentType":{"type":"string","description":"Type of document.","enum":["PASSPORT","ARTICLES_OF_ASSOCIATION","OTHER","AGREEMENT","DIRECTORS_REGISTRY","INCORPORATION_ARTICLES","INCORPORATION_CERT","PROOF_OF_ADDRESS","SHAREHOLDER_REGISTRY","POWER_OF_ATTORNEY","STATE_REGISTRY","EVIDENCE_OF_SOURCE_OF_FUNDS","EVIDENCE_OF_SOURCE_OF_WEALTH","PROOF_OF_REGULATORY_LICENSE","PROOF_OF_BUSINESS_ACTIVITY","FUND_FLOW_EXPLANATION","AML_POLICY","FINANCIAL_STATEMENT","ORGANIZATIONAL_CHART","SHAREHOLDER_OWNERSHIP","WOLFSBERG_QUESTIONNAIRE","ID_CARD","DRIVER_LICENSE","RESIDENCE_PERMIT","SELFIE","UTILITY_BILL","KYC_FORM","BAAS_ADHESION_FORM","PJ_PARTNER_DOCUMENTS","PJ_PARTNER_FINANCIAL_STATEMENT","SIGNING_AUTHORITY_PROOF","KYC_MONITORING_EVIDENCE"],"example":"ARTICLES_OF_ASSOCIATION","isRequired":true,"uniqueKey":"requirements.errors.items.[INDEX].oneOf.0.documentType","typeLabel":"enum\u003cstring>"},"documentSubType":{"oneOf":[{"type":"string","description":"Sub-classification of the document. Set when the `documentType` requires a specific side (e.g., `FRONT_SIDE` for `ID_CARD`).\n","enum":["FRONT_SIDE","BACK_SIDE"],"example":"FRONT_SIDE","uniqueKey":"requirements.errors.items.[INDEX].oneOf.0.documentSubType.oneOf.0","typeLabel":"enum\u003cstring>"},{"type":"null","description":"Sub-classification of the document. Set when the `documentType` requires a specific side (e.g., `FRONT_SIDE` for `ID_CARD`).\n","uniqueKey":"requirements.errors.items.[INDEX].oneOf.0.documentSubType.oneOf.1","typeLabel":"null"}],"uniqueKey":"requirements.errors.items.[INDEX].oneOf.0.documentSubType","typeLabel":"enum\u003cstring> | null"},"requiredMetadata":{"oneOf":[{"type":"array","description":"Metadata keys that must accompany the document upload (e.g., `country`, `number`).","items":{"type":"string","uniqueKey":"requirements.errors.items.[INDEX].oneOf.0.requiredMetadata.oneOf.0.items.[INDEX]","typeLabel":"string"},"example":["country"],"uniqueKey":"requirements.errors.items.[INDEX].oneOf.0.requiredMetadata.oneOf.0","typeLabel":"string[]"},{"type":"null","description":"Metadata keys that must accompany the document upload (e.g., `country`, `number`).","items":{"type":"string"},"example":["country"],"uniqueKey":"requirements.errors.items.[INDEX].oneOf.0.requiredMetadata.oneOf.1","typeLabel":"null"}],"uniqueKey":"requirements.errors.items.[INDEX].oneOf.0.requiredMetadata","typeLabel":"string[] | null"},"metadata":{"oneOf":[{"type":"object","additionalProperties":{"type":"string","uniqueKey":"requirements.errors.items.[INDEX].oneOf.0.metadata.oneOf.0.additionalProperties","typeLabel":"string"},"description":"Metadata captured for an already-fulfilled requirement.","uniqueKey":"requirements.errors.items.[INDEX].oneOf.0.metadata.oneOf.0","typeLabel":"object"},{"type":"null","additionalProperties":{"type":"string","uniqueKey":"requirements.errors.items.[INDEX].oneOf.0.metadata.oneOf.1.additionalProperties","typeLabel":"string"},"description":"Metadata captured for an already-fulfilled requirement.","uniqueKey":"requirements.errors.items.[INDEX].oneOf.0.metadata.oneOf.1","typeLabel":"null"}],"uniqueKey":"requirements.errors.items.[INDEX].oneOf.0.metadata","typeLabel":"object | null"},"reason":{"oneOf":[{"type":"object","description":"Explains why a state transition occurred.","properties":{"code":{"type":"string","description":"Machine-readable error code.","example":"DOCUMENT_REJECTED","isRequired":true,"uniqueKey":"requirements.errors.items.[INDEX].oneOf.0.reason.oneOf.0.code","typeLabel":"string"},"message":{"type":"string","description":"Human-readable description.","example":"Document is illegible","isRequired":true,"uniqueKey":"requirements.errors.items.[INDEX].oneOf.0.reason.oneOf.0.message","typeLabel":"string"},"details":{"type":"object","additionalProperties":true,"description":"Additional context. May be empty.","example":{},"isRequired":true,"uniqueKey":"requirements.errors.items.[INDEX].oneOf.0.reason.oneOf.0.details","typeLabel":"object"}},"required":["code","message","details"],"uniqueKey":"requirements.errors.items.[INDEX].oneOf.0.reason.oneOf.0","typeLabel":"object"},{"type":"null","description":"Explains why a state transition occurred.","properties":{"code":{"type":"string","description":"Machine-readable error code.","example":"DOCUMENT_REJECTED"},"message":{"type":"string","description":"Human-readable description.","example":"Document is illegible"},"details":{"type":"object","additionalProperties":true,"description":"Additional context. May be empty.","example":{}}},"required":["code","message","details"],"uniqueKey":"requirements.errors.items.[INDEX].oneOf.0.reason.oneOf.1","typeLabel":"null"}],"uniqueKey":"requirements.errors.items.[INDEX].oneOf.0.reason","typeLabel":"object | null"}},"uniqueKey":"requirements.errors.items.[INDEX].oneOf.0","typeLabel":"Account document · object"},{"type":"object","title":"UBO document","description":"A single requirement. The `type` field discriminates between six shapes:\n\n- `ACCOUNT_DOCUMENT`: a specific document is required at the account level.\n- `UBO_DOCUMENT`: a specific document is required for a beneficial owner.\n- `IDENTITY_VERIFICATION`: any one document from `options` satisfies an identity verification requirement.\n- `INCORPORATION_DOCUMENT`: any one document from `options` satisfies an incorporation requirement.\n- `ACCOUNT_FIELD`: an account-level field was rejected during review.\n- `UBO_FIELD`: a UBO field was rejected during review.\n","required":["documentType","type","uboId"],"properties":{"type":{"type":"string","enum":["UBO_DOCUMENT"],"isRequired":true,"uniqueKey":"requirements.errors.items.[INDEX].oneOf.1.type","typeLabel":"enum\u003cstring>"},"uboId":{"type":"string","format":"uuid","description":"Identifier of the beneficial owner this document belongs to.","example":"a1b2c3d4-e5f6-7890-1234-567890abcdef","isRequired":true,"uniqueKey":"requirements.errors.items.[INDEX].oneOf.1.uboId","typeLabel":"string\u003cuuid>"},"documentType":{"type":"string","description":"Type of document.","enum":["PASSPORT","ARTICLES_OF_ASSOCIATION","OTHER","AGREEMENT","DIRECTORS_REGISTRY","INCORPORATION_ARTICLES","INCORPORATION_CERT","PROOF_OF_ADDRESS","SHAREHOLDER_REGISTRY","POWER_OF_ATTORNEY","STATE_REGISTRY","EVIDENCE_OF_SOURCE_OF_FUNDS","EVIDENCE_OF_SOURCE_OF_WEALTH","PROOF_OF_REGULATORY_LICENSE","PROOF_OF_BUSINESS_ACTIVITY","FUND_FLOW_EXPLANATION","AML_POLICY","FINANCIAL_STATEMENT","ORGANIZATIONAL_CHART","SHAREHOLDER_OWNERSHIP","WOLFSBERG_QUESTIONNAIRE","ID_CARD","DRIVER_LICENSE","RESIDENCE_PERMIT","SELFIE","UTILITY_BILL","KYC_FORM","BAAS_ADHESION_FORM","PJ_PARTNER_DOCUMENTS","PJ_PARTNER_FINANCIAL_STATEMENT","SIGNING_AUTHORITY_PROOF","KYC_MONITORING_EVIDENCE"],"example":"ARTICLES_OF_ASSOCIATION","isRequired":true,"uniqueKey":"requirements.errors.items.[INDEX].oneOf.1.documentType","typeLabel":"enum\u003cstring>"},"documentSubType":{"oneOf":[{"type":"string","description":"Sub-classification of the document. Set when the `documentType` requires a specific side (e.g., `FRONT_SIDE` for `ID_CARD`).\n","enum":["FRONT_SIDE","BACK_SIDE"],"example":"FRONT_SIDE","uniqueKey":"requirements.errors.items.[INDEX].oneOf.1.documentSubType.oneOf.0","typeLabel":"enum\u003cstring>"},{"type":"null","description":"Sub-classification of the document. Set when the `documentType` requires a specific side (e.g., `FRONT_SIDE` for `ID_CARD`).\n","uniqueKey":"requirements.errors.items.[INDEX].oneOf.1.documentSubType.oneOf.1","typeLabel":"null"}],"uniqueKey":"requirements.errors.items.[INDEX].oneOf.1.documentSubType","typeLabel":"enum\u003cstring> | null"},"requiredMetadata":{"oneOf":[{"type":"array","description":"Metadata keys that must accompany the document upload (e.g., `country`, `number`).","items":{"type":"string","uniqueKey":"requirements.errors.items.[INDEX].oneOf.1.requiredMetadata.oneOf.0.items.[INDEX]","typeLabel":"string"},"example":["country"],"uniqueKey":"requirements.errors.items.[INDEX].oneOf.1.requiredMetadata.oneOf.0","typeLabel":"string[]"},{"type":"null","description":"Metadata keys that must accompany the document upload (e.g., `country`, `number`).","items":{"type":"string"},"example":["country"],"uniqueKey":"requirements.errors.items.[INDEX].oneOf.1.requiredMetadata.oneOf.1","typeLabel":"null"}],"uniqueKey":"requirements.errors.items.[INDEX].oneOf.1.requiredMetadata","typeLabel":"string[] | null"},"metadata":{"oneOf":[{"type":"object","additionalProperties":{"type":"string","uniqueKey":"requirements.errors.items.[INDEX].oneOf.1.metadata.oneOf.0.additionalProperties","typeLabel":"string"},"description":"Metadata captured for an already-fulfilled requirement.","uniqueKey":"requirements.errors.items.[INDEX].oneOf.1.metadata.oneOf.0","typeLabel":"object"},{"type":"null","additionalProperties":{"type":"string","uniqueKey":"requirements.errors.items.[INDEX].oneOf.1.metadata.oneOf.1.additionalProperties","typeLabel":"string"},"description":"Metadata captured for an already-fulfilled requirement.","uniqueKey":"requirements.errors.items.[INDEX].oneOf.1.metadata.oneOf.1","typeLabel":"null"}],"uniqueKey":"requirements.errors.items.[INDEX].oneOf.1.metadata","typeLabel":"object | null"},"reason":{"oneOf":[{"type":"object","description":"Explains why a state transition occurred.","properties":{"code":{"type":"string","description":"Machine-readable error code.","example":"DOCUMENT_REJECTED","isRequired":true,"uniqueKey":"requirements.errors.items.[INDEX].oneOf.1.reason.oneOf.0.code","typeLabel":"string"},"message":{"type":"string","description":"Human-readable description.","example":"Document is illegible","isRequired":true,"uniqueKey":"requirements.errors.items.[INDEX].oneOf.1.reason.oneOf.0.message","typeLabel":"string"},"details":{"type":"object","additionalProperties":true,"description":"Additional context. May be empty.","example":{},"isRequired":true,"uniqueKey":"requirements.errors.items.[INDEX].oneOf.1.reason.oneOf.0.details","typeLabel":"object"}},"required":["code","message","details"],"uniqueKey":"requirements.errors.items.[INDEX].oneOf.1.reason.oneOf.0","typeLabel":"object"},{"type":"null","description":"Explains why a state transition occurred.","properties":{"code":{"type":"string","description":"Machine-readable error code.","example":"DOCUMENT_REJECTED"},"message":{"type":"string","description":"Human-readable description.","example":"Document is illegible"},"details":{"type":"object","additionalProperties":true,"description":"Additional context. May be empty.","example":{}}},"required":["code","message","details"],"uniqueKey":"requirements.errors.items.[INDEX].oneOf.1.reason.oneOf.1","typeLabel":"null"}],"uniqueKey":"requirements.errors.items.[INDEX].oneOf.1.reason","typeLabel":"object | null"}},"uniqueKey":"requirements.errors.items.[INDEX].oneOf.1","typeLabel":"UBO document · object"},{"type":"object","title":"Identity verification","description":"A single requirement. The `type` field discriminates between six shapes:\n\n- `ACCOUNT_DOCUMENT`: a specific document is required at the account level.\n- `UBO_DOCUMENT`: a specific document is required for a beneficial owner.\n- `IDENTITY_VERIFICATION`: any one document from `options` satisfies an identity verification requirement.\n- `INCORPORATION_DOCUMENT`: any one document from `options` satisfies an incorporation requirement.\n- `ACCOUNT_FIELD`: an account-level field was rejected during review.\n- `UBO_FIELD`: a UBO field was rejected during review.\n","required":["options","type"],"properties":{"type":{"type":"string","enum":["IDENTITY_VERIFICATION"],"isRequired":true,"uniqueKey":"requirements.errors.items.[INDEX].oneOf.2.type","typeLabel":"enum\u003cstring>"},"options":{"type":"array","description":"Acceptable document options that satisfy this requirement.","items":{"type":"object","description":"One acceptable document type within a grouped requirement, together with the sub-types and metadata keys the client must supply when uploading that type. `subTypes` and `requiredMetadata` are omitted when empty.\n","properties":{"documentType":{"type":"string","description":"Type of document.","enum":["PASSPORT","ARTICLES_OF_ASSOCIATION","OTHER","AGREEMENT","DIRECTORS_REGISTRY","INCORPORATION_ARTICLES","INCORPORATION_CERT","PROOF_OF_ADDRESS","SHAREHOLDER_REGISTRY","POWER_OF_ATTORNEY","STATE_REGISTRY","EVIDENCE_OF_SOURCE_OF_FUNDS","EVIDENCE_OF_SOURCE_OF_WEALTH","PROOF_OF_REGULATORY_LICENSE","PROOF_OF_BUSINESS_ACTIVITY","FUND_FLOW_EXPLANATION","AML_POLICY","FINANCIAL_STATEMENT","ORGANIZATIONAL_CHART","SHAREHOLDER_OWNERSHIP","WOLFSBERG_QUESTIONNAIRE","ID_CARD","DRIVER_LICENSE","RESIDENCE_PERMIT","SELFIE","UTILITY_BILL","KYC_FORM","BAAS_ADHESION_FORM","PJ_PARTNER_DOCUMENTS","PJ_PARTNER_FINANCIAL_STATEMENT","SIGNING_AUTHORITY_PROOF","KYC_MONITORING_EVIDENCE"],"example":"ARTICLES_OF_ASSOCIATION","isRequired":true,"uniqueKey":"requirements.errors.items.[INDEX].oneOf.2.options.items.[INDEX].documentType","typeLabel":"enum\u003cstring>"},"subTypes":{"type":"array","description":"Sub-classifications required for this document type (e.g., `FRONT_SIDE` and `BACK_SIDE` for `ID_CARD`). Omitted when the document type has no sub-types.","items":{"type":"string","description":"Sub-classification for documents that have multiple sides.","enum":["FRONT_SIDE","BACK_SIDE"],"example":"FRONT_SIDE","uniqueKey":"requirements.errors.items.[INDEX].oneOf.2.options.items.[INDEX].subTypes.items.[INDEX]","typeLabel":"enum\u003cstring>"},"uniqueKey":"requirements.errors.items.[INDEX].oneOf.2.options.items.[INDEX].subTypes","typeLabel":"enum\u003cstring>[]"},"requiredMetadata":{"type":"array","description":"Metadata keys that must accompany the upload of this document type (e.g., `country`, `number`). Omitted when no metadata is required.","items":{"type":"string","uniqueKey":"requirements.errors.items.[INDEX].oneOf.2.options.items.[INDEX].requiredMetadata.items.[INDEX]","typeLabel":"string"},"example":["country"],"uniqueKey":"requirements.errors.items.[INDEX].oneOf.2.options.items.[INDEX].requiredMetadata","typeLabel":"string[]"}},"required":["documentType"],"uniqueKey":"requirements.errors.items.[INDEX].oneOf.2.options.items.[INDEX]","typeLabel":"object"},"isRequired":true,"uniqueKey":"requirements.errors.items.[INDEX].oneOf.2.options","typeLabel":"object[]"},"uboId":{"oneOf":[{"type":"string","format":"uuid","description":"Identifier of the beneficial owner this requirement belongs to. Omitted for account-level requirements.","example":"a1b2c3d4-e5f6-7890-1234-567890abcdef","uniqueKey":"requirements.errors.items.[INDEX].oneOf.2.uboId.oneOf.0","typeLabel":"string\u003cuuid>"},{"type":"null","format":"uuid","description":"Identifier of the beneficial owner this requirement belongs to. Omitted for account-level requirements.","example":"a1b2c3d4-e5f6-7890-1234-567890abcdef","uniqueKey":"requirements.errors.items.[INDEX].oneOf.2.uboId.oneOf.1","typeLabel":"null"}],"uniqueKey":"requirements.errors.items.[INDEX].oneOf.2.uboId","typeLabel":"string\u003cuuid> | null"}},"uniqueKey":"requirements.errors.items.[INDEX].oneOf.2","typeLabel":"Identity verification · object"},{"type":"object","title":"Incorporation document","description":"A single requirement. The `type` field discriminates between six shapes:\n\n- `ACCOUNT_DOCUMENT`: a specific document is required at the account level.\n- `UBO_DOCUMENT`: a specific document is required for a beneficial owner.\n- `IDENTITY_VERIFICATION`: any one document from `options` satisfies an identity verification requirement.\n- `INCORPORATION_DOCUMENT`: any one document from `options` satisfies an incorporation requirement.\n- `ACCOUNT_FIELD`: an account-level field was rejected during review.\n- `UBO_FIELD`: a UBO field was rejected during review.\n","required":["options","type"],"properties":{"type":{"type":"string","enum":["INCORPORATION_DOCUMENT"],"isRequired":true,"uniqueKey":"requirements.errors.items.[INDEX].oneOf.3.type","typeLabel":"enum\u003cstring>"},"options":{"type":"array","description":"Acceptable document options that satisfy this requirement.","items":{"type":"object","description":"One acceptable document type within a grouped requirement, together with the sub-types and metadata keys the client must supply when uploading that type. `subTypes` and `requiredMetadata` are omitted when empty.\n","properties":{"documentType":{"type":"string","description":"Type of document.","enum":["PASSPORT","ARTICLES_OF_ASSOCIATION","OTHER","AGREEMENT","DIRECTORS_REGISTRY","INCORPORATION_ARTICLES","INCORPORATION_CERT","PROOF_OF_ADDRESS","SHAREHOLDER_REGISTRY","POWER_OF_ATTORNEY","STATE_REGISTRY","EVIDENCE_OF_SOURCE_OF_FUNDS","EVIDENCE_OF_SOURCE_OF_WEALTH","PROOF_OF_REGULATORY_LICENSE","PROOF_OF_BUSINESS_ACTIVITY","FUND_FLOW_EXPLANATION","AML_POLICY","FINANCIAL_STATEMENT","ORGANIZATIONAL_CHART","SHAREHOLDER_OWNERSHIP","WOLFSBERG_QUESTIONNAIRE","ID_CARD","DRIVER_LICENSE","RESIDENCE_PERMIT","SELFIE","UTILITY_BILL","KYC_FORM","BAAS_ADHESION_FORM","PJ_PARTNER_DOCUMENTS","PJ_PARTNER_FINANCIAL_STATEMENT","SIGNING_AUTHORITY_PROOF","KYC_MONITORING_EVIDENCE"],"example":"ARTICLES_OF_ASSOCIATION","isRequired":true,"uniqueKey":"requirements.errors.items.[INDEX].oneOf.3.options.items.[INDEX].documentType","typeLabel":"enum\u003cstring>"},"subTypes":{"type":"array","description":"Sub-classifications required for this document type (e.g., `FRONT_SIDE` and `BACK_SIDE` for `ID_CARD`). Omitted when the document type has no sub-types.","items":{"type":"string","description":"Sub-classification for documents that have multiple sides.","enum":["FRONT_SIDE","BACK_SIDE"],"example":"FRONT_SIDE","uniqueKey":"requirements.errors.items.[INDEX].oneOf.3.options.items.[INDEX].subTypes.items.[INDEX]","typeLabel":"enum\u003cstring>"},"uniqueKey":"requirements.errors.items.[INDEX].oneOf.3.options.items.[INDEX].subTypes","typeLabel":"enum\u003cstring>[]"},"requiredMetadata":{"type":"array","description":"Metadata keys that must accompany the upload of this document type (e.g., `country`, `number`). Omitted when no metadata is required.","items":{"type":"string","uniqueKey":"requirements.errors.items.[INDEX].oneOf.3.options.items.[INDEX].requiredMetadata.items.[INDEX]","typeLabel":"string"},"example":["country"],"uniqueKey":"requirements.errors.items.[INDEX].oneOf.3.options.items.[INDEX].requiredMetadata","typeLabel":"string[]"}},"required":["documentType"],"uniqueKey":"requirements.errors.items.[INDEX].oneOf.3.options.items.[INDEX]","typeLabel":"object"},"isRequired":true,"uniqueKey":"requirements.errors.items.[INDEX].oneOf.3.options","typeLabel":"object[]"},"uboId":{"oneOf":[{"type":"string","format":"uuid","description":"Identifier of the beneficial owner this requirement belongs to. Omitted for account-level requirements.","example":"a1b2c3d4-e5f6-7890-1234-567890abcdef","uniqueKey":"requirements.errors.items.[INDEX].oneOf.3.uboId.oneOf.0","typeLabel":"string\u003cuuid>"},{"type":"null","format":"uuid","description":"Identifier of the beneficial owner this requirement belongs to. Omitted for account-level requirements.","example":"a1b2c3d4-e5f6-7890-1234-567890abcdef","uniqueKey":"requirements.errors.items.[INDEX].oneOf.3.uboId.oneOf.1","typeLabel":"null"}],"uniqueKey":"requirements.errors.items.[INDEX].oneOf.3.uboId","typeLabel":"string\u003cuuid> | null"}},"uniqueKey":"requirements.errors.items.[INDEX].oneOf.3","typeLabel":"Incorporation document · object"},{"type":"object","title":"Account field rejection","description":"A single requirement. The `type` field discriminates between six shapes:\n\n- `ACCOUNT_DOCUMENT`: a specific document is required at the account level.\n- `UBO_DOCUMENT`: a specific document is required for a beneficial owner.\n- `IDENTITY_VERIFICATION`: any one document from `options` satisfies an identity verification requirement.\n- `INCORPORATION_DOCUMENT`: any one document from `options` satisfies an incorporation requirement.\n- `ACCOUNT_FIELD`: an account-level field was rejected during review.\n- `UBO_FIELD`: a UBO field was rejected during review.\n","required":["type","fieldName","reason"],"properties":{"type":{"type":"string","enum":["ACCOUNT_FIELD"],"isRequired":true,"uniqueKey":"requirements.errors.items.[INDEX].oneOf.4.type","typeLabel":"enum\u003cstring>"},"fieldName":{"type":"string","description":"Name of the rejected field.","example":"owner.legalName","isRequired":true,"uniqueKey":"requirements.errors.items.[INDEX].oneOf.4.fieldName","typeLabel":"string"},"reason":{"oneOf":[{"type":"object","description":"Explains why a state transition occurred.","properties":{"code":{"type":"string","description":"Machine-readable error code.","example":"DOCUMENT_REJECTED","isRequired":true,"uniqueKey":"requirements.errors.items.[INDEX].oneOf.4.reason.oneOf.0.code","typeLabel":"string"},"message":{"type":"string","description":"Human-readable description.","example":"Document is illegible","isRequired":true,"uniqueKey":"requirements.errors.items.[INDEX].oneOf.4.reason.oneOf.0.message","typeLabel":"string"},"details":{"type":"object","additionalProperties":true,"description":"Additional context. May be empty.","example":{},"isRequired":true,"uniqueKey":"requirements.errors.items.[INDEX].oneOf.4.reason.oneOf.0.details","typeLabel":"object"}},"required":["code","message","details"],"isRequired":true,"uniqueKey":"requirements.errors.items.[INDEX].oneOf.4.reason.oneOf.0","typeLabel":"object"},{"type":"null","description":"Explains why a state transition occurred.","properties":{"code":{"type":"string","description":"Machine-readable error code.","example":"DOCUMENT_REJECTED"},"message":{"type":"string","description":"Human-readable description.","example":"Document is illegible"},"details":{"type":"object","additionalProperties":true,"description":"Additional context. May be empty.","example":{}}},"required":["code","message","details"],"isRequired":true,"uniqueKey":"requirements.errors.items.[INDEX].oneOf.4.reason.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"requirements.errors.items.[INDEX].oneOf.4.reason","typeLabel":"object | null"}},"uniqueKey":"requirements.errors.items.[INDEX].oneOf.4","typeLabel":"Account field rejection · object"},{"type":"object","title":"UBO field rejection","description":"A single requirement. The `type` field discriminates between six shapes:\n\n- `ACCOUNT_DOCUMENT`: a specific document is required at the account level.\n- `UBO_DOCUMENT`: a specific document is required for a beneficial owner.\n- `IDENTITY_VERIFICATION`: any one document from `options` satisfies an identity verification requirement.\n- `INCORPORATION_DOCUMENT`: any one document from `options` satisfies an incorporation requirement.\n- `ACCOUNT_FIELD`: an account-level field was rejected during review.\n- `UBO_FIELD`: a UBO field was rejected during review.\n","required":["type","fieldName","uboId","reason"],"properties":{"type":{"type":"string","enum":["UBO_FIELD"],"isRequired":true,"uniqueKey":"requirements.errors.items.[INDEX].oneOf.5.type","typeLabel":"enum\u003cstring>"},"fieldName":{"type":"string","description":"Name of the rejected field.","example":"name","isRequired":true,"uniqueKey":"requirements.errors.items.[INDEX].oneOf.5.fieldName","typeLabel":"string"},"uboId":{"type":"string","description":"Identifier of the beneficial owner whose field was rejected.","example":"a1b2c3d4-e5f6-7890-1234-567890abcdef","isRequired":true,"uniqueKey":"requirements.errors.items.[INDEX].oneOf.5.uboId","typeLabel":"string"},"reason":{"oneOf":[{"type":"object","description":"Explains why a state transition occurred.","properties":{"code":{"type":"string","description":"Machine-readable error code.","example":"DOCUMENT_REJECTED","isRequired":true,"uniqueKey":"requirements.errors.items.[INDEX].oneOf.5.reason.oneOf.0.code","typeLabel":"string"},"message":{"type":"string","description":"Human-readable description.","example":"Document is illegible","isRequired":true,"uniqueKey":"requirements.errors.items.[INDEX].oneOf.5.reason.oneOf.0.message","typeLabel":"string"},"details":{"type":"object","additionalProperties":true,"description":"Additional context. May be empty.","example":{},"isRequired":true,"uniqueKey":"requirements.errors.items.[INDEX].oneOf.5.reason.oneOf.0.details","typeLabel":"object"}},"required":["code","message","details"],"isRequired":true,"uniqueKey":"requirements.errors.items.[INDEX].oneOf.5.reason.oneOf.0","typeLabel":"object"},{"type":"null","description":"Explains why a state transition occurred.","properties":{"code":{"type":"string","description":"Machine-readable error code.","example":"DOCUMENT_REJECTED"},"message":{"type":"string","description":"Human-readable description.","example":"Document is illegible"},"details":{"type":"object","additionalProperties":true,"description":"Additional context. May be empty.","example":{}}},"required":["code","message","details"],"isRequired":true,"uniqueKey":"requirements.errors.items.[INDEX].oneOf.5.reason.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"requirements.errors.items.[INDEX].oneOf.5.reason","typeLabel":"object | null"}},"uniqueKey":"requirements.errors.items.[INDEX].oneOf.5","typeLabel":"UBO field rejection · object"}],"uniqueKey":"requirements.errors.items.[INDEX]","typeLabel":"Account document · object | UBO document · object | Identity verification · object | Incorporation document · object | Account field rejection · object | UBO field rejection · object"},"isRequired":true,"uniqueKey":"requirements.errors","typeLabel":"(Account document · object | UBO document · object | Identity verification · object | Incorporation document · object | Account field rejection · object | UBO field rejection · object)[]"},"satisfied":{"type":"array","description":"Fulfilled requirements.","items":{"oneOf":[{"type":"object","title":"Account document","description":"A single requirement. The `type` field discriminates between six shapes:\n\n- `ACCOUNT_DOCUMENT`: a specific document is required at the account level.\n- `UBO_DOCUMENT`: a specific document is required for a beneficial owner.\n- `IDENTITY_VERIFICATION`: any one document from `options` satisfies an identity verification requirement.\n- `INCORPORATION_DOCUMENT`: any one document from `options` satisfies an incorporation requirement.\n- `ACCOUNT_FIELD`: an account-level field was rejected during review.\n- `UBO_FIELD`: a UBO field was rejected during review.\n","required":["documentType","type"],"properties":{"type":{"type":"string","enum":["ACCOUNT_DOCUMENT"],"isRequired":true,"uniqueKey":"requirements.satisfied.items.[INDEX].oneOf.0.type","typeLabel":"enum\u003cstring>"},"documentType":{"type":"string","description":"Type of document.","enum":["PASSPORT","ARTICLES_OF_ASSOCIATION","OTHER","AGREEMENT","DIRECTORS_REGISTRY","INCORPORATION_ARTICLES","INCORPORATION_CERT","PROOF_OF_ADDRESS","SHAREHOLDER_REGISTRY","POWER_OF_ATTORNEY","STATE_REGISTRY","EVIDENCE_OF_SOURCE_OF_FUNDS","EVIDENCE_OF_SOURCE_OF_WEALTH","PROOF_OF_REGULATORY_LICENSE","PROOF_OF_BUSINESS_ACTIVITY","FUND_FLOW_EXPLANATION","AML_POLICY","FINANCIAL_STATEMENT","ORGANIZATIONAL_CHART","SHAREHOLDER_OWNERSHIP","WOLFSBERG_QUESTIONNAIRE","ID_CARD","DRIVER_LICENSE","RESIDENCE_PERMIT","SELFIE","UTILITY_BILL","KYC_FORM","BAAS_ADHESION_FORM","PJ_PARTNER_DOCUMENTS","PJ_PARTNER_FINANCIAL_STATEMENT","SIGNING_AUTHORITY_PROOF","KYC_MONITORING_EVIDENCE"],"example":"ARTICLES_OF_ASSOCIATION","isRequired":true,"uniqueKey":"requirements.satisfied.items.[INDEX].oneOf.0.documentType","typeLabel":"enum\u003cstring>"},"documentSubType":{"oneOf":[{"type":"string","description":"Sub-classification of the document. Set when the `documentType` requires a specific side (e.g., `FRONT_SIDE` for `ID_CARD`).\n","enum":["FRONT_SIDE","BACK_SIDE"],"example":"FRONT_SIDE","uniqueKey":"requirements.satisfied.items.[INDEX].oneOf.0.documentSubType.oneOf.0","typeLabel":"enum\u003cstring>"},{"type":"null","description":"Sub-classification of the document. Set when the `documentType` requires a specific side (e.g., `FRONT_SIDE` for `ID_CARD`).\n","uniqueKey":"requirements.satisfied.items.[INDEX].oneOf.0.documentSubType.oneOf.1","typeLabel":"null"}],"uniqueKey":"requirements.satisfied.items.[INDEX].oneOf.0.documentSubType","typeLabel":"enum\u003cstring> | null"},"requiredMetadata":{"oneOf":[{"type":"array","description":"Metadata keys that must accompany the document upload (e.g., `country`, `number`).","items":{"type":"string","uniqueKey":"requirements.satisfied.items.[INDEX].oneOf.0.requiredMetadata.oneOf.0.items.[INDEX]","typeLabel":"string"},"example":["country"],"uniqueKey":"requirements.satisfied.items.[INDEX].oneOf.0.requiredMetadata.oneOf.0","typeLabel":"string[]"},{"type":"null","description":"Metadata keys that must accompany the document upload (e.g., `country`, `number`).","items":{"type":"string"},"example":["country"],"uniqueKey":"requirements.satisfied.items.[INDEX].oneOf.0.requiredMetadata.oneOf.1","typeLabel":"null"}],"uniqueKey":"requirements.satisfied.items.[INDEX].oneOf.0.requiredMetadata","typeLabel":"string[] | null"},"metadata":{"oneOf":[{"type":"object","additionalProperties":{"type":"string","uniqueKey":"requirements.satisfied.items.[INDEX].oneOf.0.metadata.oneOf.0.additionalProperties","typeLabel":"string"},"description":"Metadata captured for an already-fulfilled requirement.","uniqueKey":"requirements.satisfied.items.[INDEX].oneOf.0.metadata.oneOf.0","typeLabel":"object"},{"type":"null","additionalProperties":{"type":"string","uniqueKey":"requirements.satisfied.items.[INDEX].oneOf.0.metadata.oneOf.1.additionalProperties","typeLabel":"string"},"description":"Metadata captured for an already-fulfilled requirement.","uniqueKey":"requirements.satisfied.items.[INDEX].oneOf.0.metadata.oneOf.1","typeLabel":"null"}],"uniqueKey":"requirements.satisfied.items.[INDEX].oneOf.0.metadata","typeLabel":"object | null"},"reason":{"oneOf":[{"type":"object","description":"Explains why a state transition occurred.","properties":{"code":{"type":"string","description":"Machine-readable error code.","example":"DOCUMENT_REJECTED","isRequired":true,"uniqueKey":"requirements.satisfied.items.[INDEX].oneOf.0.reason.oneOf.0.code","typeLabel":"string"},"message":{"type":"string","description":"Human-readable description.","example":"Document is illegible","isRequired":true,"uniqueKey":"requirements.satisfied.items.[INDEX].oneOf.0.reason.oneOf.0.message","typeLabel":"string"},"details":{"type":"object","additionalProperties":true,"description":"Additional context. May be empty.","example":{},"isRequired":true,"uniqueKey":"requirements.satisfied.items.[INDEX].oneOf.0.reason.oneOf.0.details","typeLabel":"object"}},"required":["code","message","details"],"uniqueKey":"requirements.satisfied.items.[INDEX].oneOf.0.reason.oneOf.0","typeLabel":"object"},{"type":"null","description":"Explains why a state transition occurred.","properties":{"code":{"type":"string","description":"Machine-readable error code.","example":"DOCUMENT_REJECTED"},"message":{"type":"string","description":"Human-readable description.","example":"Document is illegible"},"details":{"type":"object","additionalProperties":true,"description":"Additional context. May be empty.","example":{}}},"required":["code","message","details"],"uniqueKey":"requirements.satisfied.items.[INDEX].oneOf.0.reason.oneOf.1","typeLabel":"null"}],"uniqueKey":"requirements.satisfied.items.[INDEX].oneOf.0.reason","typeLabel":"object | null"}},"uniqueKey":"requirements.satisfied.items.[INDEX].oneOf.0","typeLabel":"Account document · object"},{"type":"object","title":"UBO document","description":"A single requirement. The `type` field discriminates between six shapes:\n\n- `ACCOUNT_DOCUMENT`: a specific document is required at the account level.\n- `UBO_DOCUMENT`: a specific document is required for a beneficial owner.\n- `IDENTITY_VERIFICATION`: any one document from `options` satisfies an identity verification requirement.\n- `INCORPORATION_DOCUMENT`: any one document from `options` satisfies an incorporation requirement.\n- `ACCOUNT_FIELD`: an account-level field was rejected during review.\n- `UBO_FIELD`: a UBO field was rejected during review.\n","required":["documentType","type","uboId"],"properties":{"type":{"type":"string","enum":["UBO_DOCUMENT"],"isRequired":true,"uniqueKey":"requirements.satisfied.items.[INDEX].oneOf.1.type","typeLabel":"enum\u003cstring>"},"uboId":{"type":"string","format":"uuid","description":"Identifier of the beneficial owner this document belongs to.","example":"a1b2c3d4-e5f6-7890-1234-567890abcdef","isRequired":true,"uniqueKey":"requirements.satisfied.items.[INDEX].oneOf.1.uboId","typeLabel":"string\u003cuuid>"},"documentType":{"type":"string","description":"Type of document.","enum":["PASSPORT","ARTICLES_OF_ASSOCIATION","OTHER","AGREEMENT","DIRECTORS_REGISTRY","INCORPORATION_ARTICLES","INCORPORATION_CERT","PROOF_OF_ADDRESS","SHAREHOLDER_REGISTRY","POWER_OF_ATTORNEY","STATE_REGISTRY","EVIDENCE_OF_SOURCE_OF_FUNDS","EVIDENCE_OF_SOURCE_OF_WEALTH","PROOF_OF_REGULATORY_LICENSE","PROOF_OF_BUSINESS_ACTIVITY","FUND_FLOW_EXPLANATION","AML_POLICY","FINANCIAL_STATEMENT","ORGANIZATIONAL_CHART","SHAREHOLDER_OWNERSHIP","WOLFSBERG_QUESTIONNAIRE","ID_CARD","DRIVER_LICENSE","RESIDENCE_PERMIT","SELFIE","UTILITY_BILL","KYC_FORM","BAAS_ADHESION_FORM","PJ_PARTNER_DOCUMENTS","PJ_PARTNER_FINANCIAL_STATEMENT","SIGNING_AUTHORITY_PROOF","KYC_MONITORING_EVIDENCE"],"example":"ARTICLES_OF_ASSOCIATION","isRequired":true,"uniqueKey":"requirements.satisfied.items.[INDEX].oneOf.1.documentType","typeLabel":"enum\u003cstring>"},"documentSubType":{"oneOf":[{"type":"string","description":"Sub-classification of the document. Set when the `documentType` requires a specific side (e.g., `FRONT_SIDE` for `ID_CARD`).\n","enum":["FRONT_SIDE","BACK_SIDE"],"example":"FRONT_SIDE","uniqueKey":"requirements.satisfied.items.[INDEX].oneOf.1.documentSubType.oneOf.0","typeLabel":"enum\u003cstring>"},{"type":"null","description":"Sub-classification of the document. Set when the `documentType` requires a specific side (e.g., `FRONT_SIDE` for `ID_CARD`).\n","uniqueKey":"requirements.satisfied.items.[INDEX].oneOf.1.documentSubType.oneOf.1","typeLabel":"null"}],"uniqueKey":"requirements.satisfied.items.[INDEX].oneOf.1.documentSubType","typeLabel":"enum\u003cstring> | null"},"requiredMetadata":{"oneOf":[{"type":"array","description":"Metadata keys that must accompany the document upload (e.g., `country`, `number`).","items":{"type":"string","uniqueKey":"requirements.satisfied.items.[INDEX].oneOf.1.requiredMetadata.oneOf.0.items.[INDEX]","typeLabel":"string"},"example":["country"],"uniqueKey":"requirements.satisfied.items.[INDEX].oneOf.1.requiredMetadata.oneOf.0","typeLabel":"string[]"},{"type":"null","description":"Metadata keys that must accompany the document upload (e.g., `country`, `number`).","items":{"type":"string"},"example":["country"],"uniqueKey":"requirements.satisfied.items.[INDEX].oneOf.1.requiredMetadata.oneOf.1","typeLabel":"null"}],"uniqueKey":"requirements.satisfied.items.[INDEX].oneOf.1.requiredMetadata","typeLabel":"string[] | null"},"metadata":{"oneOf":[{"type":"object","additionalProperties":{"type":"string","uniqueKey":"requirements.satisfied.items.[INDEX].oneOf.1.metadata.oneOf.0.additionalProperties","typeLabel":"string"},"description":"Metadata captured for an already-fulfilled requirement.","uniqueKey":"requirements.satisfied.items.[INDEX].oneOf.1.metadata.oneOf.0","typeLabel":"object"},{"type":"null","additionalProperties":{"type":"string","uniqueKey":"requirements.satisfied.items.[INDEX].oneOf.1.metadata.oneOf.1.additionalProperties","typeLabel":"string"},"description":"Metadata captured for an already-fulfilled requirement.","uniqueKey":"requirements.satisfied.items.[INDEX].oneOf.1.metadata.oneOf.1","typeLabel":"null"}],"uniqueKey":"requirements.satisfied.items.[INDEX].oneOf.1.metadata","typeLabel":"object | null"},"reason":{"oneOf":[{"type":"object","description":"Explains why a state transition occurred.","properties":{"code":{"type":"string","description":"Machine-readable error code.","example":"DOCUMENT_REJECTED","isRequired":true,"uniqueKey":"requirements.satisfied.items.[INDEX].oneOf.1.reason.oneOf.0.code","typeLabel":"string"},"message":{"type":"string","description":"Human-readable description.","example":"Document is illegible","isRequired":true,"uniqueKey":"requirements.satisfied.items.[INDEX].oneOf.1.reason.oneOf.0.message","typeLabel":"string"},"details":{"type":"object","additionalProperties":true,"description":"Additional context. May be empty.","example":{},"isRequired":true,"uniqueKey":"requirements.satisfied.items.[INDEX].oneOf.1.reason.oneOf.0.details","typeLabel":"object"}},"required":["code","message","details"],"uniqueKey":"requirements.satisfied.items.[INDEX].oneOf.1.reason.oneOf.0","typeLabel":"object"},{"type":"null","description":"Explains why a state transition occurred.","properties":{"code":{"type":"string","description":"Machine-readable error code.","example":"DOCUMENT_REJECTED"},"message":{"type":"string","description":"Human-readable description.","example":"Document is illegible"},"details":{"type":"object","additionalProperties":true,"description":"Additional context. May be empty.","example":{}}},"required":["code","message","details"],"uniqueKey":"requirements.satisfied.items.[INDEX].oneOf.1.reason.oneOf.1","typeLabel":"null"}],"uniqueKey":"requirements.satisfied.items.[INDEX].oneOf.1.reason","typeLabel":"object | null"}},"uniqueKey":"requirements.satisfied.items.[INDEX].oneOf.1","typeLabel":"UBO document · object"},{"type":"object","title":"Identity verification","description":"A single requirement. The `type` field discriminates between six shapes:\n\n- `ACCOUNT_DOCUMENT`: a specific document is required at the account level.\n- `UBO_DOCUMENT`: a specific document is required for a beneficial owner.\n- `IDENTITY_VERIFICATION`: any one document from `options` satisfies an identity verification requirement.\n- `INCORPORATION_DOCUMENT`: any one document from `options` satisfies an incorporation requirement.\n- `ACCOUNT_FIELD`: an account-level field was rejected during review.\n- `UBO_FIELD`: a UBO field was rejected during review.\n","required":["options","type"],"properties":{"type":{"type":"string","enum":["IDENTITY_VERIFICATION"],"isRequired":true,"uniqueKey":"requirements.satisfied.items.[INDEX].oneOf.2.type","typeLabel":"enum\u003cstring>"},"options":{"type":"array","description":"Acceptable document options that satisfy this requirement.","items":{"type":"object","description":"One acceptable document type within a grouped requirement, together with the sub-types and metadata keys the client must supply when uploading that type. `subTypes` and `requiredMetadata` are omitted when empty.\n","properties":{"documentType":{"type":"string","description":"Type of document.","enum":["PASSPORT","ARTICLES_OF_ASSOCIATION","OTHER","AGREEMENT","DIRECTORS_REGISTRY","INCORPORATION_ARTICLES","INCORPORATION_CERT","PROOF_OF_ADDRESS","SHAREHOLDER_REGISTRY","POWER_OF_ATTORNEY","STATE_REGISTRY","EVIDENCE_OF_SOURCE_OF_FUNDS","EVIDENCE_OF_SOURCE_OF_WEALTH","PROOF_OF_REGULATORY_LICENSE","PROOF_OF_BUSINESS_ACTIVITY","FUND_FLOW_EXPLANATION","AML_POLICY","FINANCIAL_STATEMENT","ORGANIZATIONAL_CHART","SHAREHOLDER_OWNERSHIP","WOLFSBERG_QUESTIONNAIRE","ID_CARD","DRIVER_LICENSE","RESIDENCE_PERMIT","SELFIE","UTILITY_BILL","KYC_FORM","BAAS_ADHESION_FORM","PJ_PARTNER_DOCUMENTS","PJ_PARTNER_FINANCIAL_STATEMENT","SIGNING_AUTHORITY_PROOF","KYC_MONITORING_EVIDENCE"],"example":"ARTICLES_OF_ASSOCIATION","isRequired":true,"uniqueKey":"requirements.satisfied.items.[INDEX].oneOf.2.options.items.[INDEX].documentType","typeLabel":"enum\u003cstring>"},"subTypes":{"type":"array","description":"Sub-classifications required for this document type (e.g., `FRONT_SIDE` and `BACK_SIDE` for `ID_CARD`). Omitted when the document type has no sub-types.","items":{"type":"string","description":"Sub-classification for documents that have multiple sides.","enum":["FRONT_SIDE","BACK_SIDE"],"example":"FRONT_SIDE","uniqueKey":"requirements.satisfied.items.[INDEX].oneOf.2.options.items.[INDEX].subTypes.items.[INDEX]","typeLabel":"enum\u003cstring>"},"uniqueKey":"requirements.satisfied.items.[INDEX].oneOf.2.options.items.[INDEX].subTypes","typeLabel":"enum\u003cstring>[]"},"requiredMetadata":{"type":"array","description":"Metadata keys that must accompany the upload of this document type (e.g., `country`, `number`). Omitted when no metadata is required.","items":{"type":"string","uniqueKey":"requirements.satisfied.items.[INDEX].oneOf.2.options.items.[INDEX].requiredMetadata.items.[INDEX]","typeLabel":"string"},"example":["country"],"uniqueKey":"requirements.satisfied.items.[INDEX].oneOf.2.options.items.[INDEX].requiredMetadata","typeLabel":"string[]"}},"required":["documentType"],"uniqueKey":"requirements.satisfied.items.[INDEX].oneOf.2.options.items.[INDEX]","typeLabel":"object"},"isRequired":true,"uniqueKey":"requirements.satisfied.items.[INDEX].oneOf.2.options","typeLabel":"object[]"},"uboId":{"oneOf":[{"type":"string","format":"uuid","description":"Identifier of the beneficial owner this requirement belongs to. Omitted for account-level requirements.","example":"a1b2c3d4-e5f6-7890-1234-567890abcdef","uniqueKey":"requirements.satisfied.items.[INDEX].oneOf.2.uboId.oneOf.0","typeLabel":"string\u003cuuid>"},{"type":"null","format":"uuid","description":"Identifier of the beneficial owner this requirement belongs to. Omitted for account-level requirements.","example":"a1b2c3d4-e5f6-7890-1234-567890abcdef","uniqueKey":"requirements.satisfied.items.[INDEX].oneOf.2.uboId.oneOf.1","typeLabel":"null"}],"uniqueKey":"requirements.satisfied.items.[INDEX].oneOf.2.uboId","typeLabel":"string\u003cuuid> | null"}},"uniqueKey":"requirements.satisfied.items.[INDEX].oneOf.2","typeLabel":"Identity verification · object"},{"type":"object","title":"Incorporation document","description":"A single requirement. The `type` field discriminates between six shapes:\n\n- `ACCOUNT_DOCUMENT`: a specific document is required at the account level.\n- `UBO_DOCUMENT`: a specific document is required for a beneficial owner.\n- `IDENTITY_VERIFICATION`: any one document from `options` satisfies an identity verification requirement.\n- `INCORPORATION_DOCUMENT`: any one document from `options` satisfies an incorporation requirement.\n- `ACCOUNT_FIELD`: an account-level field was rejected during review.\n- `UBO_FIELD`: a UBO field was rejected during review.\n","required":["options","type"],"properties":{"type":{"type":"string","enum":["INCORPORATION_DOCUMENT"],"isRequired":true,"uniqueKey":"requirements.satisfied.items.[INDEX].oneOf.3.type","typeLabel":"enum\u003cstring>"},"options":{"type":"array","description":"Acceptable document options that satisfy this requirement.","items":{"type":"object","description":"One acceptable document type within a grouped requirement, together with the sub-types and metadata keys the client must supply when uploading that type. `subTypes` and `requiredMetadata` are omitted when empty.\n","properties":{"documentType":{"type":"string","description":"Type of document.","enum":["PASSPORT","ARTICLES_OF_ASSOCIATION","OTHER","AGREEMENT","DIRECTORS_REGISTRY","INCORPORATION_ARTICLES","INCORPORATION_CERT","PROOF_OF_ADDRESS","SHAREHOLDER_REGISTRY","POWER_OF_ATTORNEY","STATE_REGISTRY","EVIDENCE_OF_SOURCE_OF_FUNDS","EVIDENCE_OF_SOURCE_OF_WEALTH","PROOF_OF_REGULATORY_LICENSE","PROOF_OF_BUSINESS_ACTIVITY","FUND_FLOW_EXPLANATION","AML_POLICY","FINANCIAL_STATEMENT","ORGANIZATIONAL_CHART","SHAREHOLDER_OWNERSHIP","WOLFSBERG_QUESTIONNAIRE","ID_CARD","DRIVER_LICENSE","RESIDENCE_PERMIT","SELFIE","UTILITY_BILL","KYC_FORM","BAAS_ADHESION_FORM","PJ_PARTNER_DOCUMENTS","PJ_PARTNER_FINANCIAL_STATEMENT","SIGNING_AUTHORITY_PROOF","KYC_MONITORING_EVIDENCE"],"example":"ARTICLES_OF_ASSOCIATION","isRequired":true,"uniqueKey":"requirements.satisfied.items.[INDEX].oneOf.3.options.items.[INDEX].documentType","typeLabel":"enum\u003cstring>"},"subTypes":{"type":"array","description":"Sub-classifications required for this document type (e.g., `FRONT_SIDE` and `BACK_SIDE` for `ID_CARD`). Omitted when the document type has no sub-types.","items":{"type":"string","description":"Sub-classification for documents that have multiple sides.","enum":["FRONT_SIDE","BACK_SIDE"],"example":"FRONT_SIDE","uniqueKey":"requirements.satisfied.items.[INDEX].oneOf.3.options.items.[INDEX].subTypes.items.[INDEX]","typeLabel":"enum\u003cstring>"},"uniqueKey":"requirements.satisfied.items.[INDEX].oneOf.3.options.items.[INDEX].subTypes","typeLabel":"enum\u003cstring>[]"},"requiredMetadata":{"type":"array","description":"Metadata keys that must accompany the upload of this document type (e.g., `country`, `number`). Omitted when no metadata is required.","items":{"type":"string","uniqueKey":"requirements.satisfied.items.[INDEX].oneOf.3.options.items.[INDEX].requiredMetadata.items.[INDEX]","typeLabel":"string"},"example":["country"],"uniqueKey":"requirements.satisfied.items.[INDEX].oneOf.3.options.items.[INDEX].requiredMetadata","typeLabel":"string[]"}},"required":["documentType"],"uniqueKey":"requirements.satisfied.items.[INDEX].oneOf.3.options.items.[INDEX]","typeLabel":"object"},"isRequired":true,"uniqueKey":"requirements.satisfied.items.[INDEX].oneOf.3.options","typeLabel":"object[]"},"uboId":{"oneOf":[{"type":"string","format":"uuid","description":"Identifier of the beneficial owner this requirement belongs to. Omitted for account-level requirements.","example":"a1b2c3d4-e5f6-7890-1234-567890abcdef","uniqueKey":"requirements.satisfied.items.[INDEX].oneOf.3.uboId.oneOf.0","typeLabel":"string\u003cuuid>"},{"type":"null","format":"uuid","description":"Identifier of the beneficial owner this requirement belongs to. Omitted for account-level requirements.","example":"a1b2c3d4-e5f6-7890-1234-567890abcdef","uniqueKey":"requirements.satisfied.items.[INDEX].oneOf.3.uboId.oneOf.1","typeLabel":"null"}],"uniqueKey":"requirements.satisfied.items.[INDEX].oneOf.3.uboId","typeLabel":"string\u003cuuid> | null"}},"uniqueKey":"requirements.satisfied.items.[INDEX].oneOf.3","typeLabel":"Incorporation document · object"},{"type":"object","title":"Account field rejection","description":"A single requirement. The `type` field discriminates between six shapes:\n\n- `ACCOUNT_DOCUMENT`: a specific document is required at the account level.\n- `UBO_DOCUMENT`: a specific document is required for a beneficial owner.\n- `IDENTITY_VERIFICATION`: any one document from `options` satisfies an identity verification requirement.\n- `INCORPORATION_DOCUMENT`: any one document from `options` satisfies an incorporation requirement.\n- `ACCOUNT_FIELD`: an account-level field was rejected during review.\n- `UBO_FIELD`: a UBO field was rejected during review.\n","required":["type","fieldName","reason"],"properties":{"type":{"type":"string","enum":["ACCOUNT_FIELD"],"isRequired":true,"uniqueKey":"requirements.satisfied.items.[INDEX].oneOf.4.type","typeLabel":"enum\u003cstring>"},"fieldName":{"type":"string","description":"Name of the rejected field.","example":"owner.legalName","isRequired":true,"uniqueKey":"requirements.satisfied.items.[INDEX].oneOf.4.fieldName","typeLabel":"string"},"reason":{"oneOf":[{"type":"object","description":"Explains why a state transition occurred.","properties":{"code":{"type":"string","description":"Machine-readable error code.","example":"DOCUMENT_REJECTED","isRequired":true,"uniqueKey":"requirements.satisfied.items.[INDEX].oneOf.4.reason.oneOf.0.code","typeLabel":"string"},"message":{"type":"string","description":"Human-readable description.","example":"Document is illegible","isRequired":true,"uniqueKey":"requirements.satisfied.items.[INDEX].oneOf.4.reason.oneOf.0.message","typeLabel":"string"},"details":{"type":"object","additionalProperties":true,"description":"Additional context. May be empty.","example":{},"isRequired":true,"uniqueKey":"requirements.satisfied.items.[INDEX].oneOf.4.reason.oneOf.0.details","typeLabel":"object"}},"required":["code","message","details"],"isRequired":true,"uniqueKey":"requirements.satisfied.items.[INDEX].oneOf.4.reason.oneOf.0","typeLabel":"object"},{"type":"null","description":"Explains why a state transition occurred.","properties":{"code":{"type":"string","description":"Machine-readable error code.","example":"DOCUMENT_REJECTED"},"message":{"type":"string","description":"Human-readable description.","example":"Document is illegible"},"details":{"type":"object","additionalProperties":true,"description":"Additional context. May be empty.","example":{}}},"required":["code","message","details"],"isRequired":true,"uniqueKey":"requirements.satisfied.items.[INDEX].oneOf.4.reason.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"requirements.satisfied.items.[INDEX].oneOf.4.reason","typeLabel":"object | null"}},"uniqueKey":"requirements.satisfied.items.[INDEX].oneOf.4","typeLabel":"Account field rejection · object"},{"type":"object","title":"UBO field rejection","description":"A single requirement. The `type` field discriminates between six shapes:\n\n- `ACCOUNT_DOCUMENT`: a specific document is required at the account level.\n- `UBO_DOCUMENT`: a specific document is required for a beneficial owner.\n- `IDENTITY_VERIFICATION`: any one document from `options` satisfies an identity verification requirement.\n- `INCORPORATION_DOCUMENT`: any one document from `options` satisfies an incorporation requirement.\n- `ACCOUNT_FIELD`: an account-level field was rejected during review.\n- `UBO_FIELD`: a UBO field was rejected during review.\n","required":["type","fieldName","uboId","reason"],"properties":{"type":{"type":"string","enum":["UBO_FIELD"],"isRequired":true,"uniqueKey":"requirements.satisfied.items.[INDEX].oneOf.5.type","typeLabel":"enum\u003cstring>"},"fieldName":{"type":"string","description":"Name of the rejected field.","example":"name","isRequired":true,"uniqueKey":"requirements.satisfied.items.[INDEX].oneOf.5.fieldName","typeLabel":"string"},"uboId":{"type":"string","description":"Identifier of the beneficial owner whose field was rejected.","example":"a1b2c3d4-e5f6-7890-1234-567890abcdef","isRequired":true,"uniqueKey":"requirements.satisfied.items.[INDEX].oneOf.5.uboId","typeLabel":"string"},"reason":{"oneOf":[{"type":"object","description":"Explains why a state transition occurred.","properties":{"code":{"type":"string","description":"Machine-readable error code.","example":"DOCUMENT_REJECTED","isRequired":true,"uniqueKey":"requirements.satisfied.items.[INDEX].oneOf.5.reason.oneOf.0.code","typeLabel":"string"},"message":{"type":"string","description":"Human-readable description.","example":"Document is illegible","isRequired":true,"uniqueKey":"requirements.satisfied.items.[INDEX].oneOf.5.reason.oneOf.0.message","typeLabel":"string"},"details":{"type":"object","additionalProperties":true,"description":"Additional context. May be empty.","example":{},"isRequired":true,"uniqueKey":"requirements.satisfied.items.[INDEX].oneOf.5.reason.oneOf.0.details","typeLabel":"object"}},"required":["code","message","details"],"isRequired":true,"uniqueKey":"requirements.satisfied.items.[INDEX].oneOf.5.reason.oneOf.0","typeLabel":"object"},{"type":"null","description":"Explains why a state transition occurred.","properties":{"code":{"type":"string","description":"Machine-readable error code.","example":"DOCUMENT_REJECTED"},"message":{"type":"string","description":"Human-readable description.","example":"Document is illegible"},"details":{"type":"object","additionalProperties":true,"description":"Additional context. May be empty.","example":{}}},"required":["code","message","details"],"isRequired":true,"uniqueKey":"requirements.satisfied.items.[INDEX].oneOf.5.reason.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"requirements.satisfied.items.[INDEX].oneOf.5.reason","typeLabel":"object | null"}},"uniqueKey":"requirements.satisfied.items.[INDEX].oneOf.5","typeLabel":"UBO field rejection · object"}],"uniqueKey":"requirements.satisfied.items.[INDEX]","typeLabel":"Account document · object | UBO document · object | Identity verification · object | Incorporation document · object | Account field rejection · object | UBO field rejection · object"},"isRequired":true,"uniqueKey":"requirements.satisfied","typeLabel":"(Account document · object | UBO document · object | Identity verification · object | Incorporation document · object | Account field rejection · object | UBO field rejection · object)[]"}},"required":["currentlyDue","pendingVerification","errors","satisfied"],"isRequired":true,"uniqueKey":"requirements","typeLabel":"object"},"tags":{"type":"array","description":"System-managed labels attached to the account. Some tags propagate to operations executed against this account.\n","items":{"type":"object","description":"A label attached to a resource. Tags are system-managed — Trace Finance assigns them based on routing, compliance, and operational criteria. Clients cannot create, modify, or remove tags via the API.\n","properties":{"value":{"type":"string","description":"For keyed tags, the right-hand side of the label. For single-value labels, the entire tag.\n","example":"Amazon","isRequired":true,"uniqueKey":"tags.items.[INDEX].value","typeLabel":"string"},"key":{"oneOf":[{"type":"string","description":"Category for keyed tags (e.g., `psp`, `compliance-tier`). `null` for single-value labels.\n","example":"psp","uniqueKey":"tags.items.[INDEX].key.oneOf.0","typeLabel":"string"},{"type":"null","description":"Category for keyed tags (e.g., `psp`, `compliance-tier`). `null` for single-value labels.\n","example":"psp","uniqueKey":"tags.items.[INDEX].key.oneOf.1","typeLabel":"null"}],"uniqueKey":"tags.items.[INDEX].key","typeLabel":"string | null"}},"required":["value"],"uniqueKey":"tags.items.[INDEX]","typeLabel":"object"},"example":[{"key":"psp","value":"Amazon"},{"key":null,"value":"hidden"},{"key":"compliance-tier","value":"high"}],"isRequired":true,"uniqueKey":"tags","typeLabel":"object[]"},"currentState":{"type":"object","description":"A point-in-time state of the account.","properties":{"status":{"type":"string","enum":["ACTION_REQUIRED","REVIEWING","OPENING","ACTIVE","REJECTED","CLOSED"],"example":"ACTION_REQUIRED","isRequired":true,"uniqueKey":"currentState.status","typeLabel":"enum\u003cstring>"},"createdAt":{"type":"string","format":"date-time","example":"2026-01-15T10:30:00Z","isRequired":true,"uniqueKey":"currentState.createdAt","typeLabel":"string\u003cdate-time>"},"reason":{"oneOf":[{"type":"object","description":"Explains why a state transition occurred.","properties":{"code":{"type":"string","description":"Machine-readable error code.","example":"DOCUMENT_REJECTED","isRequired":true,"uniqueKey":"currentState.reason.oneOf.0.code","typeLabel":"string"},"message":{"type":"string","description":"Human-readable description.","example":"Document is illegible","isRequired":true,"uniqueKey":"currentState.reason.oneOf.0.message","typeLabel":"string"},"details":{"type":"object","additionalProperties":true,"description":"Additional context. May be empty.","example":{},"isRequired":true,"uniqueKey":"currentState.reason.oneOf.0.details","typeLabel":"object"}},"required":["code","message","details"],"uniqueKey":"currentState.reason.oneOf.0","typeLabel":"object"},{"type":"null","description":"Explains why a state transition occurred.","properties":{"code":{"type":"string","description":"Machine-readable error code.","example":"DOCUMENT_REJECTED"},"message":{"type":"string","description":"Human-readable description.","example":"Document is illegible"},"details":{"type":"object","additionalProperties":true,"description":"Additional context. May be empty.","example":{}}},"required":["code","message","details"],"uniqueKey":"currentState.reason.oneOf.1","typeLabel":"null"}],"uniqueKey":"currentState.reason","typeLabel":"object | null"}},"required":["status","createdAt"],"isRequired":true,"uniqueKey":"currentState","typeLabel":"object"},"states":{"type":"array","description":"Full state history of the account.","items":{"type":"object","description":"A point-in-time state of the account.","properties":{"status":{"type":"string","enum":["ACTION_REQUIRED","REVIEWING","OPENING","ACTIVE","REJECTED","CLOSED"],"example":"ACTION_REQUIRED","isRequired":true,"uniqueKey":"states.items.[INDEX].status","typeLabel":"enum\u003cstring>"},"createdAt":{"type":"string","format":"date-time","example":"2026-01-15T10:30:00Z","isRequired":true,"uniqueKey":"states.items.[INDEX].createdAt","typeLabel":"string\u003cdate-time>"},"reason":{"oneOf":[{"type":"object","description":"Explains why a state transition occurred.","properties":{"code":{"type":"string","description":"Machine-readable error code.","example":"DOCUMENT_REJECTED","isRequired":true,"uniqueKey":"states.items.[INDEX].reason.oneOf.0.code","typeLabel":"string"},"message":{"type":"string","description":"Human-readable description.","example":"Document is illegible","isRequired":true,"uniqueKey":"states.items.[INDEX].reason.oneOf.0.message","typeLabel":"string"},"details":{"type":"object","additionalProperties":true,"description":"Additional context. May be empty.","example":{},"isRequired":true,"uniqueKey":"states.items.[INDEX].reason.oneOf.0.details","typeLabel":"object"}},"required":["code","message","details"],"uniqueKey":"states.items.[INDEX].reason.oneOf.0","typeLabel":"object"},{"type":"null","description":"Explains why a state transition occurred.","properties":{"code":{"type":"string","description":"Machine-readable error code.","example":"DOCUMENT_REJECTED"},"message":{"type":"string","description":"Human-readable description.","example":"Document is illegible"},"details":{"type":"object","additionalProperties":true,"description":"Additional context. May be empty.","example":{}}},"required":["code","message","details"],"uniqueKey":"states.items.[INDEX].reason.oneOf.1","typeLabel":"null"}],"uniqueKey":"states.items.[INDEX].reason","typeLabel":"object | null"}},"required":["status","createdAt"],"uniqueKey":"states.items.[INDEX]","typeLabel":"object"},"isRequired":true,"uniqueKey":"states","typeLabel":"object[]"},"createdAt":{"type":"string","format":"date-time","example":"2026-01-15T10:30:00Z","readOnly":true,"isRequired":true,"uniqueKey":"createdAt","typeLabel":"string\u003cdate-time>"},"updatedAt":{"type":"string","format":"date-time","example":"2026-01-15T10:30:00Z","readOnly":true,"isRequired":true,"uniqueKey":"updatedAt","typeLabel":"string\u003cdate-time>"},"sourceAccountId":{"oneOf":[{"type":"string","format":"uuid","description":"Parent account ID. Null for named accounts.","example":null,"uniqueKey":"sourceAccountId.oneOf.0","typeLabel":"string\u003cuuid>"},{"type":"null","format":"uuid","description":"Parent account ID. Null for named accounts.","example":null,"uniqueKey":"sourceAccountId.oneOf.1","typeLabel":"null"}],"uniqueKey":"sourceAccountId","typeLabel":"string\u003cuuid> | null"}},"required":["id","customer","owner","assets","requirements","tags","currentState","states","createdAt","updatedAt"],"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"id":"a1b2c3d4-5e6f-7890-abcd-ef1234567890","customer":{"id":"c1a2b3c4-d5e6-7890-abcd-ef1234567890"},"owner":{"type":"COMPANY","legalName":"Acme Ltda","identificationDocument":{"type":"CNPJ","value":"11222333000181","country":"BR"},"industry":"SOFTWARE_DEVELOPMENT","expectedMonthlyVolume":"FROM_0_TO_50000","address":{"addressLine1":"Rua das Flores, 100","city":"São Paulo","country":"BR","postalCode":"01234-567","addressLine2":"Suite 456","state":"SP"},"ubos":[{"id":"b2c3d4e5-f6a7-8901-bcde-f12345678901","name":"João Silva","identificationDocument":{"type":"CNPJ","value":"11222333000181","country":"BR"},"address":{"addressLine1":"Rua das Flores, 100","city":"São Paulo","country":"BR","postalCode":"01234-567","addressLine2":"Suite 456","state":"SP"},"phone":"5511999999999","email":"joao.silva@example.com","isLegalRepresentative":false,"currentState":{"status":"PENDING","createdAt":"2026-01-15T10:30:00Z","reason":{"code":"DOCUMENT_REJECTED","message":"Document is illegible","details":{}}},"ownershipPercentage":50}]},"assets":[{"currency":"BRL","allowsVirtualAccounts":false,"status":"ONBOARDING"}],"requirements":{"currentlyDue":[{"type":"ACCOUNT_DOCUMENT","documentType":"ARTICLES_OF_ASSOCIATION","documentSubType":"FRONT_SIDE","requiredMetadata":["country"],"metadata":{},"reason":{"code":"DOCUMENT_REJECTED","message":"Document is illegible","details":{}}}],"pendingVerification":[{"type":"ACCOUNT_DOCUMENT","documentType":"ARTICLES_OF_ASSOCIATION","documentSubType":"FRONT_SIDE","requiredMetadata":["country"],"metadata":{},"reason":{"code":"DOCUMENT_REJECTED","message":"Document is illegible","details":{}}}],"errors":[{"type":"ACCOUNT_DOCUMENT","documentType":"ARTICLES_OF_ASSOCIATION","documentSubType":"FRONT_SIDE","requiredMetadata":["country"],"metadata":{},"reason":{"code":"DOCUMENT_REJECTED","message":"Document is illegible","details":{}}}],"satisfied":[{"type":"ACCOUNT_DOCUMENT","documentType":"ARTICLES_OF_ASSOCIATION","documentSubType":"FRONT_SIDE","requiredMetadata":["country"],"metadata":{},"reason":{"code":"DOCUMENT_REJECTED","message":"Document is illegible","details":{}}}]},"tags":[{"key":"psp","value":"Amazon"},{"key":null,"value":"hidden"},{"key":"compliance-tier","value":"high"}],"currentState":{"status":"ACTION_REQUIRED","createdAt":"2026-01-15T10:30:00Z","reason":{"code":"DOCUMENT_REJECTED","message":"Document is illegible","details":{}}},"states":[{"status":"ACTION_REQUIRED","createdAt":"2026-01-15T10:30:00Z","reason":{"code":"DOCUMENT_REJECTED","message":"Document is illegible","details":{}}}],"createdAt":"2026-01-15T10:30:00Z","updatedAt":"2026-01-15T10:30:00Z","sourceAccountId":null}}},"exampleType":"generated"}},"exampleType":"generated"},"505150b1-0c5d-45d9-828a-4ccfa29f4c20":{"description":"Invalid request.","headers":{"X-Request-Id":{"description":"Unique request identifier emitted on every response. Reference it when contacting Trace Finance support so we can trace the request end-to-end. See [Errors](/guides/principles/errors).","schema":{"type":"string","format":"uuid"}}},"content":{"application/json":{"schema":{"type":"object","description":"Standard error envelope. The HTTP response also carries an `X-Request-Id` header — reference it when contacting Trace Finance support. See [Errors](/guides/principles/errors).","properties":{"code":{"type":"string","description":"Machine-readable error code.","isRequired":true,"uniqueKey":"code","typeLabel":"string"},"message":{"type":"string","description":"Human-readable description.","isRequired":true,"uniqueKey":"message","typeLabel":"string"},"details":{"type":"object","additionalProperties":true,"uniqueKey":"details","typeLabel":"object"}},"required":["code","message"],"uniqueKey":"","typeLabel":"object"},"examples":{"invalidUuid":{"title":"invalidUuid","value":{"code":"INVALID_DATA","message":"Object contains invalid data","details":{"errors":[{"code":"INVALID_UUID","message":"'not-a-uuid' cannot be converted to UUID","field":"path:accountId","params":{}}]}}},"invalidData":{"title":"invalidData","value":{"code":"INVALID_DATA","message":"Object contains invalid data","details":{"errors":[{"code":"REQUIRED","message":"Parameter 'body:owner' not found in request","field":"body:owner","params":{}}]}}}},"exampleType":"examples"}},"exampleType":"examples"},"95889bbc-f66f-43f3-b1fd-f55a9367a627":{"description":"Missing or invalid authentication token.","headers":{"X-Request-Id":{"description":"Unique request identifier emitted on every response. Reference it when contacting Trace Finance support so we can trace the request end-to-end. See [Errors](/guides/principles/errors).","schema":{"type":"string","format":"uuid"}}},"content":{"application/json":{"schema":{"type":"object","description":"Standard error envelope. The HTTP response also carries an `X-Request-Id` header — reference it when contacting Trace Finance support. See [Errors](/guides/principles/errors).","properties":{"code":{"type":"string","description":"Machine-readable error code.","isRequired":true,"uniqueKey":"code","typeLabel":"string"},"message":{"type":"string","description":"Human-readable description.","isRequired":true,"uniqueKey":"message","typeLabel":"string"},"details":{"type":"object","additionalProperties":true,"uniqueKey":"details","typeLabel":"object"}},"required":["code","message"],"uniqueKey":"","typeLabel":"object"},"examples":{"invalidToken":{"title":"invalidToken","value":{"code":"INVALID_ACCESS_TOKEN","message":"Invalid access token","details":{}}},"expiredToken":{"title":"expiredToken","value":{"code":"EXPIRED_ACCESS_TOKEN","message":"Expired access token","details":{}}}},"exampleType":"examples"}},"exampleType":"examples"},"7496c6f0-9948-4e66-a277-4e155e059806":{"description":"Account not found.","headers":{"X-Request-Id":{"description":"Unique request identifier emitted on every response. Reference it when contacting Trace Finance support so we can trace the request end-to-end. See [Errors](/guides/principles/errors).","schema":{"type":"string","format":"uuid"}}},"content":{"application/json":{"schema":{"type":"object","description":"Standard error envelope. The HTTP response also carries an `X-Request-Id` header — reference it when contacting Trace Finance support. See [Errors](/guides/principles/errors).","properties":{"code":{"type":"string","description":"Machine-readable error code.","isRequired":true,"uniqueKey":"code","typeLabel":"string"},"message":{"type":"string","description":"Human-readable description.","isRequired":true,"uniqueKey":"message","typeLabel":"string"},"details":{"type":"object","additionalProperties":true,"uniqueKey":"details","typeLabel":"object"}},"required":["code","message"],"uniqueKey":"","typeLabel":"object"},"examples":{"accountNotFound":{"title":"accountNotFound","value":{"code":"RESOURCE_NOT_FOUND","message":"Account with given parameters [Account.id:5b7c1f2a-3d4e-4f8a-9b1c-2d3e4f5a6b7c, Customer.id:c1a2b3c4-d5e6-7890-abcd-ef1234567890] not found","details":{"resource":"Account","parameters":{"Account.id":"5b7c1f2a-3d4e-4f8a-9b1c-2d3e4f5a6b7c","Customer.id":"c1a2b3c4-d5e6-7890-abcd-ef1234567890"}}}}},"exampleType":"examples"}},"exampleType":"examples"},"8f78fe28-ce34-44ee-9fc8-fed132f85180":{"description":"Business rule violation.","headers":{"X-Request-Id":{"description":"Unique request identifier emitted on every response. Reference it when contacting Trace Finance support so we can trace the request end-to-end. See [Errors](/guides/principles/errors).","schema":{"type":"string","format":"uuid"}}},"content":{"application/json":{"schema":{"type":"object","description":"Standard error envelope. The HTTP response also carries an `X-Request-Id` header — reference it when contacting Trace Finance support. See [Errors](/guides/principles/errors).","properties":{"code":{"type":"string","description":"Machine-readable error code.","isRequired":true,"uniqueKey":"code","typeLabel":"string"},"message":{"type":"string","description":"Human-readable description.","isRequired":true,"uniqueKey":"message","typeLabel":"string"},"details":{"type":"object","additionalProperties":true,"uniqueKey":"details","typeLabel":"object"}},"required":["code","message"],"uniqueKey":"","typeLabel":"object"},"examples":{"accountNotModifiable":{"title":"accountNotModifiable","value":{"code":"ACCOUNT_NOT_MODIFIABLE","message":"Account is not in a modifiable state","details":{"accountId":"5b7c1f2a-3d4e-4f8a-9b1c-2d3e4f5a6b7c"}}}},"exampleType":"examples"}},"exampleType":"examples"}},"security":{"6a3df8c2-1f7c-4ec0-b29d-b6153c48d433":{"bearerAuth":{"type":"http","scheme":"bearer","bearerFormat":"JWT","description":"JWT bearer token. Include as `Authorization: Bearer \u003ctoken>`. See the [Authentication](/guides/authentication) guide for how to obtain one.","scopes":[]}}},"servers":{"4aa4e9da-008d-4557-b355-1182d5c08ea1":{"url":"https://api.sandbox.tracefinance.com","description":"Sandbox"}},"processedSecurityOptions":[{"schemes":[{"scheme":{"type":"http","scheme":"bearer","bearerFormat":"JWT","description":"JWT bearer token. Include as `Authorization: Bearer \u003ctoken>`. See the [Authentication](/guides/authentication) guide for how to obtain one.","scopes":[]},"schema":{"title":"Bearer Auth","type":"string","isRequired":true,"description":"JWT bearer token. Include as `Authorization: Bearer \u003ctoken>`. See the [Authentication](/guides/authentication) guide for how to obtain one.","format":"bearer","typeLabel":"string\u003cbearer>","deprecated":false},"schemeName":"bearerAuth","name":"Authorization"}],"title":"bearerAuth"}]},"originalFileLocation":"apis/fx-account/openapi.yml"},"subdomain":"tracefinance","siteName":"Trace Finance","title":"Update an account - Trace Finance","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-05-19T21:34:24.737Z","originalFileLocation":"api-reference/fx-account/accounts/update-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=\"dark\"}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=\"Replace the owner profile and asset selection for an account that has not been submitted for review yet.\">\u003cmeta data-mint-head name=\"application-name\" content=\"Trace Finance\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/tracefinance/BcVkRlEfQ3nPAdoA/_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/tracefinance/BcVkRlEfQ3nPAdoA/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/tracefinance/BcVkRlEfQ3nPAdoA/_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/tracefinance/BcVkRlEfQ3nPAdoA/_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/tracefinance/BcVkRlEfQ3nPAdoA/_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/tracefinance/BcVkRlEfQ3nPAdoA/_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/tracefinance/BcVkRlEfQ3nPAdoA/_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/tracefinance/BcVkRlEfQ3nPAdoA/_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/tracefinance/BcVkRlEfQ3nPAdoA/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Update an account - Trace Finance\">\u003cmeta data-mint-head property=\"og:description\" content=\"Replace the owner profile and asset selection for an account that has not been submitted for review yet.\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"Trace Finance\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://docs.tracefinance.com/api-reference/fx-account/accounts/update-account\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://tracefinance.mintlify.app/_mintlify/api/og/v2?division=Accounts\u0026amp;title=Update+an+account\u0026amp;description=Replace+the+owner+profile+and+asset+selection+for+an+account+that+has+not+been+submitted+for+review+yet.\u0026amp;theme=b76e0dddf69073b4f4160d37\u0026amp;signature=9fce961cb32babc192be678283cb765f1ff3a64d1fff4d5f4b2e80a477a60fa9\">\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=\"Update an account - Trace Finance\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Replace the owner profile and asset selection for an account that has not been submitted for review yet.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://tracefinance.mintlify.app/_mintlify/api/og/v2?division=Accounts\u0026amp;title=Update+an+account\u0026amp;description=Replace+the+owner+profile+and+asset+selection+for+an+account+that+has+not+been+submitted+for+review+yet.\u0026amp;theme=b76e0dddf69073b4f4160d37\u0026amp;signature=9fce961cb32babc192be678283cb765f1ff3a64d1fff4d5f4b2e80a477a60fa9\">\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/tracefinance/BcVkRlEfQ3nPAdoA/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"Trace Finance\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#15803D\">\u003clink data-mint-head rel=\"canonical\" href=\"https://docs.tracefinance.com/api-reference/fx-account/accounts/update-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/fx-account/accounts/update-account.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://docs.tracefinance.com/#organization\",\"name\":\"Trace Finance\",\"url\":\"https://docs.tracefinance.com\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/tracefinance/Z0lGetTZ5_xyIY5m/logo/light.svg?fit=max\u0026auto=format\u0026n=Z0lGetTZ5_xyIY5m\u0026q=85\u0026s=ba19c7b8c24c8e96c9966e48d66e0704\"}},{\"@type\":\"WebSite\",\"@id\":\"https://docs.tracefinance.com#website\",\"name\":\"Trace Finance\",\"url\":\"https://docs.tracefinance.com\",\"publisher\":{\"@id\":\"https://docs.tracefinance.com/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://docs.tracefinance.com/api-reference/fx-account/accounts/update-account#webpage\",\"url\":\"https://docs.tracefinance.com/api-reference/fx-account/accounts/update-account\",\"name\":\"Update an account\",\"description\":\"Replace the owner profile and asset selection for an account that has not been submitted for review yet.\",\"dateModified\":\"2026-05-19T21:34:24.737Z\",\"isPartOf\":{\"@id\":\"https://docs.tracefinance.com#website\"},\"breadcrumb\":{\"@id\":\"https://docs.tracefinance.com/api-reference/fx-account/accounts/update-account#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.tracefinance.com/api-reference/fx-account/accounts/update-account#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Accounts\",\"item\":\"https://docs.tracefinance.com/api-reference/fx-account/accounts/create-account\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Update an account\",\"item\":\"https://docs.tracefinance.com/api-reference/fx-account/accounts/update-account\"}]},{\"@type\":[\"TechArticle\",\"APIReference\"],\"@id\":\"https://docs.tracefinance.com/api-reference/fx-account/accounts/update-account#apireference\",\"headline\":\"Update an account\",\"name\":\"Update an account\",\"description\":\"Replace the owner profile and asset selection for an account that has not been submitted for review yet.\",\"url\":\"https://docs.tracefinance.com/api-reference/fx-account/accounts/update-account\",\"mainEntityOfPage\":{\"@id\":\"https://docs.tracefinance.com/api-reference/fx-account/accounts/update-account#webpage\"},\"dateModified\":\"2026-05-19T21:34:24.737Z\",\"publisher\":{\"@id\":\"https://docs.tracefinance.com/#organization\"},\"isPartOf\":{\"@id\":\"https://docs.tracefinance.com#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"Trace Finance\",\"creator\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","siteName":"Trace Finance","nav":{"global":null,"tabs":[{"tab":"Guides","icon":"book-open","pages":[{"title":"Guides","href":""}]},{"tab":"API Reference","icon":"code","groups":[{"group":"Accounts","icon":"building-columns","pages":[{"title":"Create an account","openapi":"apis/fx-account/openapi.yml POST /v1/accounts","href":"/api-reference/fx-account/accounts/create-account"},{"title":"List accounts","openapi":"apis/fx-account/openapi.yml GET /v1/accounts","href":"/api-reference/fx-account/accounts/list-accounts"},{"title":"Get an account","description":"Retrieves the details of an account by its ID.","openapi":"apis/fx-account/openapi.yml GET /v1/accounts/{accountId}","href":"/api-reference/fx-account/accounts/get-account"},{"title":"Update an account","openapi":"apis/fx-account/openapi.yml PATCH /v1/accounts/{accountId}","href":"/api-reference/fx-account/accounts/update-account"},{"title":"Submit account for review","description":"Submits an account for compliance review after all requirements are fulfilled.","openapi":"apis/fx-account/openapi.yml POST /v1/accounts/{accountId}/review","href":"/api-reference/fx-account/accounts/submit-account-for-review"},{"title":"Upload a document","openapi":"apis/fx-account/openapi.yml POST /v1/accounts/{accountId}/documents","href":"/api-reference/fx-account/documents/upload-document"},{"group":"UBOs","icon":"users","pages":[{"title":"Add a beneficial owner","openapi":"apis/fx-account/openapi.yml POST /v1/accounts/{accountId}/ubos","href":"/api-reference/fx-account/beneficial-owners/add-ubo"},{"title":"List beneficial owners","openapi":"apis/fx-account/openapi.yml GET /v1/accounts/{accountId}/ubos","href":"/api-reference/fx-account/beneficial-owners/list-ubos"},{"title":"Get a beneficial owner","openapi":"apis/fx-account/openapi.yml GET /v1/accounts/{accountId}/ubos/{uboId}","href":"/api-reference/fx-account/beneficial-owners/get-ubo"},{"title":"Update a beneficial owner","openapi":"apis/fx-account/openapi.yml PATCH /v1/accounts/{accountId}/ubos/{uboId}","href":"/api-reference/fx-account/beneficial-owners/update-ubo"},{"title":"Remove a beneficial owner","openapi":"apis/fx-account/openapi.yml DELETE /v1/accounts/{accountId}/ubos/{uboId}","href":"/api-reference/fx-account/beneficial-owners/remove-ubo"}]},{"group":"Funding instructions","icon":"money-bill-transfer","pages":[{"title":"List funding instructions","openapi":"apis/fx-account/openapi.yml GET /v1/accounts/{accountId}/fundingInstructions","href":"/api-reference/fx-account/funding-instructions/list-funding-instructions"}]},{"group":"Balances","icon":"wallet","pages":[{"title":"Get account balance","openapi":"apis/fx-account/openapi.yml GET /v1/accounts/{accountId}/balances","href":"/api-reference/fx-account/balances/get-balance"}]}]},{"group":"Operations","icon":"arrows-rotate","pages":[{"title":"Create a withdrawal","openapi":"apis/fx-payment/openapi.yml POST /v1/operations/withdrawals","href":"/api-reference/fx-payment/operations/create-withdrawal"},{"title":"Create a swap","openapi":"apis/fx-payment/openapi.yml POST /v1/operations/swaps","href":"/api-reference/fx-payment/operations/create-swap"},{"title":"Create a deposit","openapi":"apis/fx-payment/openapi.yml POST /v1/operations/deposits","href":"/api-reference/fx-payment/operations/create-deposit"},{"title":"Create a transfer","openapi":"apis/fx-payment/openapi.yml POST /v1/operations/transfers","href":"/api-reference/fx-payment/operations/create-transfer"},{"title":"Refund a deposit","openapi":"apis/fx-payment/openapi.yml POST /v1/operations/{operationId}/refund","href":"/api-reference/fx-payment/operations/refund-deposit"},{"title":"Get an operation","openapi":"apis/fx-payment/openapi.yml GET /v1/operations/{operationId}","href":"/api-reference/fx-payment/operations/get-operation"},{"title":"List operations","openapi":"apis/fx-payment/openapi.yml GET /v1/operations","href":"/api-reference/fx-payment/operations/list-operations"},{"title":"Upload a document","openapi":"apis/fx-payment/openapi.yml POST /v1/operations/{operationId}/documents","href":"/api-reference/fx-payment/operations/upload-operation-document"}]},{"group":"Reports","icon":"chart-line","pages":[{"title":"Get a report","openapi":"apis/fx-payment/openapi.yml GET /v1/reports","href":"/api-reference/fx-payment/reports/get-report"}]},{"group":"Quotes","icon":"scale-balanced","pages":[{"title":"Create a quote","openapi":"apis/fx-payment/openapi.yml POST /v1/quotes","href":"/api-reference/fx-payment/operations/quotes/create-quote"}]},{"group":"Beneficiaries","icon":"address-book","pages":[{"title":"Create a beneficiary","openapi":"apis/fx-payment/openapi.yml POST /v1/beneficiaries","href":"/api-reference/fx-payment/beneficiaries/create-beneficiary"},{"title":"List beneficiaries","openapi":"apis/fx-payment/openapi.yml GET /v1/beneficiaries","href":"/api-reference/fx-payment/beneficiaries/list-beneficiaries"},{"title":"Get a beneficiary","openapi":"apis/fx-payment/openapi.yml GET /v1/beneficiaries/{beneficiaryId}","href":"/api-reference/fx-payment/beneficiaries/get-beneficiary"},{"title":"Delete a beneficiary","openapi":"apis/fx-payment/openapi.yml DELETE /v1/beneficiaries/{beneficiaryId}","href":"/api-reference/fx-payment/beneficiaries/delete-beneficiary"},{"title":"Upload a document","openapi":"apis/fx-payment/openapi.yml POST /v1/beneficiaries/{beneficiaryId}/documents","href":"/api-reference/fx-payment/beneficiaries/submit-beneficiary-document"},{"group":"Payment instructions","icon":"credit-card","pages":[{"title":"Add a payment instruction","openapi":"apis/fx-payment/openapi.yml POST /v1/beneficiaries/{beneficiaryId}/payment-instructions","href":"/api-reference/fx-payment/beneficiaries/add-payment-instruction"},{"title":"Remove a payment instruction","openapi":"apis/fx-payment/openapi.yml DELETE /v1/beneficiaries/{beneficiaryId}/payment-instructions/{paymentInstructionId}","href":"/api-reference/fx-payment/beneficiaries/remove-payment-instruction"}]}]},{"group":"Webhooks","icon":"webhook","pages":[{"group":"Subscriptions","icon":"rss","pages":[{"title":"Create a subscription","openapi":"apis/fx-webhook/openapi.yml POST /v1/subscriptions","href":"/api-reference/fx-webhook/subscriptions/create-subscription"},{"title":"List subscriptions","openapi":"apis/fx-webhook/openapi.yml GET /v1/subscriptions","href":"/api-reference/fx-webhook/subscriptions/list-subscriptions"},{"title":"Get a subscription","openapi":"apis/fx-webhook/openapi.yml GET /v1/subscriptions/{subscriptionId}","href":"/api-reference/fx-webhook/subscriptions/get-subscription"},{"title":"Update a subscription","openapi":"apis/fx-webhook/openapi.yml PATCH /v1/subscriptions/{subscriptionId}","href":"/api-reference/fx-webhook/subscriptions/update-subscription"},{"title":"Delete a subscription","openapi":"apis/fx-webhook/openapi.yml DELETE /v1/subscriptions/{subscriptionId}","href":"/api-reference/fx-webhook/subscriptions/delete-subscription"}]},{"group":"Execution logs","icon":"list-check","pages":[{"title":"List execution logs","openapi":"apis/fx-webhook/openapi.yml GET /v1/subscriptions/{subscriptionId}/executionLogs","href":"/api-reference/fx-webhook/subscriptions/list-execution-logs"},{"title":"Get an execution log","openapi":"apis/fx-webhook/openapi.yml GET /v1/subscriptions/{subscriptionId}/executionLogs/{executionLogId}","href":"/api-reference/fx-webhook/subscriptions/get-execution-log"},{"title":"Resend a delivery","openapi":"apis/fx-webhook/openapi.yml POST /v1/subscriptions/{subscriptionId}/executionLogs/{executionLogId}/resend","href":"/api-reference/fx-webhook/subscriptions/resend-delivery"}]},{"group":"Events","icon":"bolt","pages":[{"group":"Account","icon":"building-columns","pages":[{"title":"Account created","openapi":"apis/fx-webhook/openapi.yml webhook ACCOUNT_CREATED","href":"/api-reference/fx-webhook/events/account/account-created"},{"title":"Action required","openapi":"apis/fx-webhook/openapi.yml webhook ACCOUNT_ACTION_REQUIRED","href":"/api-reference/fx-webhook/events/account/action-required"},{"title":"Asset activated","openapi":"apis/fx-webhook/openapi.yml webhook ACCOUNT_ASSET_ACTIVATED","href":"/api-reference/fx-webhook/events/account/account-asset-activated"},{"title":"Asset failed","openapi":"apis/fx-webhook/openapi.yml webhook ACCOUNT_ASSET_FAILED","href":"/api-reference/fx-webhook/events/account/account-asset-failed"}]},{"group":"Operation","icon":"arrows-rotate","pages":[{"title":"Requested","openapi":"apis/fx-webhook/openapi.yml webhook OPERATION_REQUESTED","href":"/api-reference/fx-webhook/events/operation/operation-requested"},{"title":"Processing","openapi":"apis/fx-webhook/openapi.yml webhook OPERATION_PROCESSING","href":"/api-reference/fx-webhook/events/operation/operation-processing"},{"title":"Action required","openapi":"apis/fx-webhook/openapi.yml webhook OPERATION_ACTION_REQUIRED","href":"/api-reference/fx-webhook/events/operation/operation-action-required"},{"title":"Completed","openapi":"apis/fx-webhook/openapi.yml webhook OPERATION_COMPLETED","href":"/api-reference/fx-webhook/events/operation/operation-completed"},{"title":"Failed","openapi":"apis/fx-webhook/openapi.yml webhook OPERATION_FAILED","href":"/api-reference/fx-webhook/events/operation/operation-failed"},{"title":"Refunding","openapi":"apis/fx-webhook/openapi.yml webhook OPERATION_REFUNDING","href":"/api-reference/fx-webhook/events/operation/operation-refunding"},{"title":"Refunded","openapi":"apis/fx-webhook/openapi.yml webhook OPERATION_REFUNDED","href":"/api-reference/fx-webhook/events/operation/operation-refunded"}]},{"group":"Beneficiary","icon":"address-book","pages":[{"title":"Instruction created","openapi":"apis/fx-webhook/openapi.yml webhook BENEFICIARY_INSTRUCTION_CREATED","href":"/api-reference/fx-webhook/events/beneficiary/beneficiary-payment-instruction-created"},{"title":"Instruction approved","openapi":"apis/fx-webhook/openapi.yml webhook BENEFICIARY_INSTRUCTION_APPROVED","href":"/api-reference/fx-webhook/events/beneficiary/beneficiary-payment-instruction-approved"},{"title":"Instruction rejected","openapi":"apis/fx-webhook/openapi.yml webhook BENEFICIARY_INSTRUCTION_REJECTED","href":"/api-reference/fx-webhook/events/beneficiary/beneficiary-payment-instruction-rejected"},{"title":"Instruction action required","openapi":"apis/fx-webhook/openapi.yml webhook BENEFICIARY_INSTRUCTION_ACTION_REQUIRED","href":"/api-reference/fx-webhook/events/beneficiary/beneficiary-payment-instruction-action-required"}]}]}]}]}]},"title":"Update an account - Trace Finance","buildId":"dpl_DFJrtvUi8HS5F9nkooKuDJsuD5BM","deploymentId":"dpl_DFJrtvUi8HS5F9nkooKuDJsuD5BM","dynamics":["c2aa737661","2b790eda92","b0f84f53ff","a9bb46feb3"],"chunks":["OpenApiReferenceProvider-rfhihCWU.js","utils-BmH1XFxk.js","cloneDeep-izs3Hzxb.js","_Uint8Array-BVIqJ90l.js","isObjectLike-C8vmzPEN.js","isArray-Dcu1dQ5t.js","utils-BcNsxPKB.js","toString-BX-iyh8G.js","isSymbol-CSH9U2Gm.js","addUniqueKeysToSchema-BAES3tkd.js","snippetPresets-DCMQBKLP.js","style-to-object-BY3JEAdk.js","v4-DIgz8zy6.js","ApiExamples-D6l_bzE9.js","isEqual-BfaiBbcl.js","usePlaygroundInputsStore-BOktbnNh.js","shallow-BCs8SgM7.js","getApiPlaygroundDisplay-DEmW5bJB.js","CodeSnippet-CpZOpB9C.js","CodeSnippets-BOBDqibl.js","Page-D5fEM6aW.js","getPastedJson-DH2JBvmr.js","icon-BBJH-kKh.js","MethodPill-D2Sd5NLC.js","DuplicateIcon-CGgfL2qN.js","createIcon-BKudBBzi.js","DynamicMarkdown-85clUA0i.js","SectionHeading-D0JiMgDx.js","axios-vUo_bRtp.js","Markdown-Cfiy0xZO.js","clsx-rL8ZCCw4.js","lib--scc4DXi.js","lib-B8HbPgcC.js","html-void-elements-mCSPHezU.js","dist-aeztFa9U.js","katex-YMM-FMeD.js","marked.esm-CZWythHk.js","AssistantPageLink-BywkCr5C.js"]}