> ## Documentation Index
> Fetch the complete documentation index at: https://docs.corebanq.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Countries overview

> Country data management and validation

## 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 status
* `sepa_member`: SEPA participation
* `risk_level`: Country risk assessment
* `supported_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)

<Note>
  See individual endpoint documentation for detailed request/response formats and examples.
</Note>
