Country API

Country reference data and per-country IBAN formats.

This documentation covers API V1.

Endpoints

http

GET https://api.fincode.example.com/v1/countries
GET https://api.fincode.example.com/v1/countries/{code}
GET https://api.fincode.example.com/v1/countries/{code}/iban-format

Example request

bash

curl -s "https://api.fincode.example.com/v1/countries/DE/iban-format" \
  -H "Authorization: Bearer sk_test_xxx"

Example response

json

{
  "data": {
    "country_code": "DE",
    "iban_length": 22,
    "structure": "DEkk BBBB BBBB BBBB BBBB BB",
    "bank_identifier_position": { "start": 5, "length": 8 },
    "account_number_position": { "start": 13, "length": 10 },
    "example": "DE89370400440532013000"
  },
  "meta": { "request_id": "req_9i8h7g6f" }
}