Update fiat address verification status

{ "bank_account_identifier": { "iban": "DE89370400440532013000", "type": "SEPA" }, "bank_details": { "account_identifier": { "iban": "DE89370400440532013000", "type": "SEPA" }, "address": { "city": "London", "country": { "code": "GB" }, "postal_code": "SW1A 2AA", "state": "England", "street": "10 Downing Street" }, "bank_address": null, "email_address": { "email": "john.doe@example.com" }, "is_third_party": false, "phone_number": "+49-30-12345678", "provider_country": { "code": "DE" }, "provider_name": "Iron Bank", "recipient": { "name": "Aperture Science", "type": "Business" } }, "bank_name": "Iron Bank", "country": "DE", "created_at": "2024-01-15T10:30:00.000Z", "currency": "EUR", "customer_id": "123e4567-e89b-12d3-a456-426614174000", "id": "550e8400-e29b-41d4-a716-446655440000", "is_third_party": false, "label": "Primary Business Account", "ownership_verified": true, "status": "Registered", "updated_at": "1970-01-01T00:00:00.000Z" }

Authorizations

X-API-Key

string

header

required

API Key

Headers

X-API-Version

string

Selects the API version for this request, as an ISO date (YYYY-MM-DD). Omit to use the default version (2025-03-13). Supported versions: 2025-03-13, 2026-07-01.

Path Parameters

string<uuid>

required

the ID of the address to update

Body

application/json; charset=utf-8

the new verification status

Verification Status

The status of the verification of a fiat address

Available options:

AuthorizationRequired,

AuthorizationFailed,

RegistrationPending,

RegistrationFailed,

Registered

Response

Update Address Succeeded

Fiat Address

Response containing fiat address details

bank_account_identifier

Iban · object

required

Show child attributes

Example:

{ "iban": "DE89370400440532013000" }

bank_details

RecipientBankAccount · object

required

RecipientBankAccount

A recipient fiat bank account

Show child attributes

Example:

{
  "account_identifier": {
    "iban": "DE89370400440532013000",
    "type": "SEPA"
  },
  "address": {
    "city": "London",
    "country": { "code": "GB" },
    "postal_code": "SW1A 2AA",
    "state": "England",
    "street": "10 Downing Street"
  },
  "bank_address": null,
  "email_address": { "email": "john.doe@example.com" },
  "is_third_party": false,
  "phone_number": "+49-30-12345678",
  "provider_country": { "code": "DE" },
  "provider_name": "Iron Bank",
  "recipient": {
    "name": "Aperture Science",
    "type": "Business"
  }
}

bank_name

string

required

The bank name

country

string

required

The country code

created_at

string<date-time>

required

When the address was created

currency

string

required

The currency of the bank account

customer_id

string<uuid>

required

The customer ID

string<uuid>

required

The ID of the address

is_third_party

boolean

required

Is this a third party fiat address

ownership_verified

boolean

required

Has the customer verified their ownership of this account

status

enum<string>

required

Verification Status

The status of the verification of a fiat address

Available options:

AuthorizationRequired,

AuthorizationFailed,

RegistrationPending,

RegistrationFailed,

Registered

updated_at

string<date-time>

required

When the address was last updated

label

string

Optional label for the address