Overview
The Countries API provides functionality for managing country data, including:- ISO codes (alpha-2, alpha-3, numeric)
- IBAN formats and validation
- Currency associations
- Regional settings
Core Concepts
Country Properties
| Field | Description | Format |
|---|---|---|
name | Country name | Required |
iso_alpha2 | Two-letter code | ISO 3166-1 alpha-2 |
iso_alpha3 | Three-letter code | ISO 3166-1 alpha-3 |
iso_numeric | Numeric code | ISO 3166-1 numeric |
iban_length | IBAN length | Integer |
currency_code | Default currency | ISO 4217 |
Metadata Options
eu_member: EU membership statussepa_member: SEPA participationrisk_level: Country risk assessmentsupported_documents: Accepted ID types
Validation Rules
ISO Codes
- Alpha-2: Exactly 2 uppercase letters
- Alpha-3: Exactly 3 uppercase letters
- Numeric: Exactly 3 digits
Currency Code
- Must be valid ISO 4217 code
- Must be active currency
Security Requirements
- Country management requires admin access
- Changes are audited
- Deletion is logical (deactivation)
See individual endpoint documentation for detailed request/response formats and examples.