An external account represents the bank account details required to send payments to or collect payments from an external account holder. External accounts can be used for payment orders, direct debit mandates, and account verifications.

Attribute	Description
id string	The external account ID.
object string	Always `external_account`.
name string	The external account usual name.
account_holder_id string	The ID of the related account holder.
holder_name string	The name of the company or individual holding the account.
holder_address object	The account holder address. See address object.
account_number string	The account number of the external account.
account_number_format string	The format of the account number. When set, it must match `account_number` unless the format is `other` or `tokenized`. One of `iban`, `uk_bank_number`, `us_account_number`, `other`, or `tokenized`.
bank_code string	The BIC / Swift code, sort code, or domestic bank code, depending on the country and bank.
bank_code_format string	The format of the bank code. When set, it must match `bank_code` unless the format is `other` or `tokenized`. One of `bic`, `uk_sorting_code`, `us_aba_routing_number`, `other`, or `tokenized`
bank_name string	The name of the bank.
bank_address object	The address of the bank. See address object.
type string	The type of the external account. Can be `individual`, `legal_entity`, or `null`.
organization_identification object	The organization identification of the internal account. See Organization identification.
company_registration_number_type string	The type of the company registration number. Supported values are `nl_kvk`, `nl_kvk_branch`, `fr_siren`, `fr_siret`, `uk_crn`, `eu_vat`, and `other`. Must be left empty for external accounts of `type` = `individual`.
company_registration_number string	The company registration number. Must match the format given by `company_registration_number`. Must be left empty for external accounts of `type` = `individual`.
status string	The status of the external account. See External account lifecycle for a comprehensive list of external account statuses.
status_details string	The reason for denying the external account.
account_verification object	The account verification results. See Account verification.
metadata object	Additional data in JSON `key:value` format. See Metadata.
custom_fields object	Custom fields in JSON key:value format. See Custom fields.
disabled_at datetime	The external account disabling UTC timestamp.
created_at datetime	The external account creation UTC timestamp.

Below is an example of an external account:

{
  "id": "39446492-3d63-4a3c-8f96-a8ed8be91c0c",
  "object": "external_account",
  "type": "legal_entity",
  "status": "approved",
  "status_details": "",
  "name": "Acme Corp. settling account",
  "holder_name": "Acme Crop.",
  "holder_address": {
    "country": "",
    "line_1": "",
    "line_2": "",
    "building_number": "",
    "street_name": "",
    "postal_code": "",
    "region_state": "",
    "city": ""
  },
  "account_number": "FR1212739000506541967515Q48",
  "bank_code": "SOMEBIC0XXX",
  "account_holder_id": null,
  "organization_identification": {
    "legal_entity_identifier": "5493001KJHG78Y4TCF23",
    "business_identification_code": null,
    "default_other_identifier_type": "siren",
    "others": [
      {
        "type": "siren",
        "value": "123456789"
      },
      {
        "type": "siret",
        "value": "123456789123"
      }
    ]
  },
  "company_registration_number": "123456789",
  "company_registration_number_type": "fr_siren",
  "metadata": {},
  "custom_fields": {},
  "account_verification": {
    "result": "valid",
    "valid_account_number": {
      "result": "valid",
      "details": {
        "reason": "",
        "expected_value": "",
        "message": ""
      }
    },
    "matching_account_number_and_bank_code": {
      "result": "valid",
      "details": {
        "reason": "",
        "expected_value": "",
        "message": ""
      }
    },
    "matching_account_holder": {
      "result": "valid",
      "details": {
        "reason": "",
        "expected_value": "",
        "message": ""
      }
    },
    "active_account": {
      "result": "valid",
      "details": {
        "reason": "",
        "expected_value": "",
        "message": ""
      }
    },
    "created_at": "2024-10-24T12:35:01.892244399Z"
  },
  "created_at": "2024-10-23T12:34:34.721347Z",
  "disabled_at": null
}