---
title: "Returns IBAN/BBAN structure for a country"
method: GET
path: "/v1/banks/iban-structure"
tags: ["BankValidation"]
---

# Returns IBAN/BBAN structure for a country

`GET /v1/banks/iban-structure`

## Request

- Base URL: `https://api.cloud.precisely.com`
- URL: `https://api.cloud.precisely.com/v1/banks/iban-structure`
- Auth: one of:
  - HTTP bearer
  - API key in header `Authorization`

Returns the IBAN length and BBAN structure for a given ISO 3166-1 alpha-2 country code.

## Query parameters

- `countryIso2` string, required

## Headers

- `X-Request-Id` string

## Response `200`

IBAN structure retrieved successfully

- StructureApiResponse: Top-level API response wrapper for IBAN structure
  - `response` StructureResponse: The response object containing the status and IBAN structure result
    - `status` 'OK' | 'ZERO_RESULTS', required: Represents the status of a response
    - `result` IbanStructureResult: IBAN and BBAN structure details for a country
      - `countryIso2` string: ISO 3166-1 alpha-2 country code
      - `ibanLength` integer: Total length of IBAN for this country
      - `bbanStructure` BbanStructureEntry[]: Ordered list of BBAN structure entries
        - `partType` string: The part type of this BBAN entry, e.g. bank_code, sort_code, account_number
        - `length` integer: The length of this BBAN entry in characters
        - `characterType` string: The character type: n (numeric), a (alphabetic), c (alphanumeric)

## Other responses

- `400`: Invalid or unsupported country code
- `401`: Unauthorized: Invalid token
- `422`: IBAN is not supported for this country
- `500`: Internal server error

---

[API](https://skmtc.dev/precisely/apis/third-party-api-service.md) · [All operations](https://skmtc.dev/precisely/apis/third-party-api-service/llms.txt) · [OpenAPI document](https://skmtc.dev/precisely/apis/third-party-api-service/revisions/cf792ff5cabd?raw)