{
"idempotency_hit": true,
"virtual_iban": {
"id": "2f8c1d4e-1111-4b22-8a33-000000000001",
"purpose": "funding_usdt",
"currency": "EUR",
"iban": "DE890000000000000000",
"iban_country": "DE",
"status": "active"
}
}{
"virtual_iban": {
"id": "2f8c1d4e-1111-4b22-8a33-000000000001",
"owner_account_id": "9b1deb4d-3b7d-4bad-9bdd-2b0d7b3dcb6d",
"manager_account_id": "",
"purpose": "funding_usdt",
"currency": "EUR",
"iban": "",
"iban_country": "",
"status": "pending_approval",
"client_order": "platform:virtual-iban:org:account:funding_usdt:viban-funding-2026-001",
"order_reference": "",
"created_at": "2026-09-10T12:00:00Z",
"updated_at": "2026-09-10T12:00:00Z"
},
"status": "pending_approval"
}{
"error": "registrant_incomplete",
"message": "missing registrant fields: individual.document.issuedCountryCode, individual.document.expirationDate"
}Request an EUR virtual IBAN
Requests one durable virtual IBAN allocation for the authenticated account. funding_usdt is the default purpose; banking_eur requires the Banking product. The platform autofills the provider V3 registrant from the approved KYC/KYB profile. The optional document and incorporation fields below accept snake_case and camelCase aliases. Company accounts also accept trading_website, business_activity, is_micro_enterprise, expected_turnover and one document pair per UBO (ubo_document_issued_country, ubodocument_expiration_date, zero-based UBO index, camelCase aliases accepted): the corporate rail requires a full document per UBO. UBO identity corrections (ubofirst_name, ubolast_name, ubo_birth_date) override a KYB carrying wrong owner data without re-verification; birth dates (person and UBOs) must yield age 16-85. tax_number works on BOTH branches: a US person/company must provide a valid 9-digit SSN/EIN; other countries validate known formats (CL RUT, GB NINO/UTR) and omit invalid values instead of failing. Names fold to the rail latin charset (José→Jose) and addresses validate zip format per country, with address_zip as correction when the KYC zip is malformed. Values already present in the approved KYB profile (incorporation, website, industry, UBO documents) are autofilled — overrides are only needed for what the profile lacks, and explicit overrides always win. Missing required registrant paths return 422 registrant_incomplete with the missing paths in message.
{
"idempotency_hit": true,
"virtual_iban": {
"id": "2f8c1d4e-1111-4b22-8a33-000000000001",
"purpose": "funding_usdt",
"currency": "EUR",
"iban": "DE890000000000000000",
"iban_country": "DE",
"status": "active"
}
}{
"virtual_iban": {
"id": "2f8c1d4e-1111-4b22-8a33-000000000001",
"owner_account_id": "9b1deb4d-3b7d-4bad-9bdd-2b0d7b3dcb6d",
"manager_account_id": "",
"purpose": "funding_usdt",
"currency": "EUR",
"iban": "",
"iban_country": "",
"status": "pending_approval",
"client_order": "platform:virtual-iban:org:account:funding_usdt:viban-funding-2026-001",
"order_reference": "",
"created_at": "2026-09-10T12:00:00Z",
"updated_at": "2026-09-10T12:00:00Z"
},
"status": "pending_approval"
}{
"error": "registrant_incomplete",
"message": "missing registrant fields: individual.document.issuedCountryCode, individual.document.expirationDate"
}Authorizations
Session JWT (from register/login) or API key (pk_...).
X-API-Key: <token> is accepted as an alternative header.
Body
funding_usdt, banking_eur ISO alpha-2 document issuing country override
CamelCase alias
Document expiry override; must be more than one month in the future
CamelCase alias
ISO alpha-2 incorporation country override
CamelCase alias
Incorporation date override
CamelCase alias
Company trading website override
CamelCase alias
Company business activity override
CamelCase alias
"true" or "false" micro-enterprise flag override
CamelCase alias
Optional expected turnover override
CamelCase alias
Tax number correction for BOTH branches (person: 9-digit SSN/ITIN when US; company: 9-digit EIN when US, valid CL RUT with check digit)
CamelCase alias
Address postal code correction when the KYC carries one with invalid country format (empty = profile value is used)
CamelCase alias
ISO alpha-2 issuing country of UBO 0 document; repeat per UBO index
CamelCase alias
UBO 0 document expiry; must be more than one month in the future; repeat per UBO index
CamelCase alias
"true" or "false" whether UBO 0 is a politically exposed person; repeat per UBO index
CamelCase alias
"true" or "false" whether UBO 0 is a US tax resident; repeat per UBO index
CamelCase alias
UBO 0 first name correction (overrides the KYB value); repeat per UBO index
CamelCase alias
UBO 0 last name correction (overrides the KYB value); repeat per UBO index
CamelCase alias
UBO 0 birth date correction (overrides the KYB value); must yield age 16-85; repeat per UBO index
CamelCase alias
Response
Idempotent replay of the same request.