---
title: Financial APIs Supported Countries Reference
version: 1.0.0
description: Retrieve the countries and states supported by the VAT, IBAN, and SWIFT APIs. The response always includes all three categories — VAT_Supported_Countries_And_States, IBAN_Supported_Countries, and SWIFT_Supported_Countries — each with a different shape. VAT entries are keyed by lowercase country name and include an ISO code plus, for a handful of countries (US, Canada, Spain), a nested map of sub-national state/region codes. IBAN and SWIFT entries are flat arrays of {name, countryCode} objects.
openapi: 3.1.1
servers:
  - https://api.apifreaks.com/v1.0
paths: 1
operations: 1
schemas: 4
---

## Table of Contents

- [Financial APIs Supported Countries Reference v1.0.0](#financial-apis-supported-countries-reference-v100)
  - [Authentication](#authentication)
  - [Financial APIs](#financial-apis)
    - [getSupportedCountries](#getsupportedcountries)
      - [Parameters](#parameters)
      - [Responses](#responses)
  - [Schemas](#schemas)
    - [SupportedCountriesResponse](#supportedcountriesresponse)
    - [VatCountryEntry](#vatcountryentry)
    - [IbanCountryEntry](#ibancountryentry)
    - [SwiftCountryEntry](#swiftcountryentry)



# Financial APIs Supported Countries Reference v1.0.0

Retrieve the countries and states supported by the VAT, IBAN, and SWIFT APIs. The response always includes all three categories — VAT_Supported_Countries_And_States, IBAN_Supported_Countries, and SWIFT_Supported_Countries — each with a different shape. VAT entries are keyed by lowercase country name and include an ISO code plus, for a handful of countries (US, Canada, Spain), a nested map of sub-national state/region codes. IBAN and SWIFT entries are flat arrays of {name, countryCode} objects.

Base URLs:

* [https://api.apifreaks.com/v1.0](https://api.apifreaks.com/v1.0)

## Authentication

* API Key (ApiKeyAuthHeader)
    - Parameter Name: **X-apiKey**, in: header. Pass your API key via the X-apiKey request header.

* API Key (ApiKeyAuthQuery)
    - Parameter Name: **apiKey**, in: query. Pass your API key via the apiKey query parameter.

## Financial APIs

### getSupportedCountries

`GET /vat/supported-countries`

*Get supported countries*

Returns the countries and states supported by the VAT, IBAN, and SWIFT APIs.

#### Parameters

|Name|In|Type|Required|Description|
|---|---|---|---|---|
|format|query|string|false|Format of the response. Default is JSON.|
|type|query|string|false|Accepted by the endpoint but currently has no effect — all three categories (VAT, IBAN, SWIFT) are always returned regardless of this value.|

##### Enumerated Values

|Parameter|Value|
|---|---|
|format|json|
|format|xml|

> Example responses

> Successful response — always returns all three categories

```json
{
  "VAT_Supported_Countries_And_States": [
    {
      "germany": {
        "code": "de"
      }
    },
    {
      "united_states": {
        "code": "us",
        "states": {
          "california": "us:ca",
          "new_york": "us:ny",
          "texas": "us:tx"
        }
      }
    }
  ],
  "IBAN_Supported_Countries": [
    {
      "countryCode": "DE",
      "name": "Germany"
    },
    {
      "countryCode": "GB",
      "name": "United Kingdom"
    }
  ],
  "SWIFT_Supported_Countries": [
    {
      "name": "Germany",
      "countryCode": "DE"
    },
    {
      "name": "United States",
      "countryCode": "US"
    }
  ]
}
```

#### Responses

|Status|Meaning|Description|Schema|
|---|---|---|---|
|200|[OK](https://tools.ietf.org/html/rfc7231#section-6.3.1)|Successful response — always returns all three categories|[SupportedCountriesResponse](#supportedcountriesresponse)|

#### Response Headers

|Status|Header|Type|Format|Description|
|---|---|---|---|---|
|200|X-AF-Credits-Cost|integer||Specifies the number of credits consumed by the current request.|

To perform this operation, you must be authenticated by means of one of the following methods:
ApiKeyAuthHeader, ApiKeyAuthQuery

## Schemas

### SupportedCountriesResponse

Countries and states supported by the VAT, IBAN, and SWIFT APIs.

#### Properties

|Name|Type|Required|Restrictions|Description|
|---|---|---|---|---|
|VAT_Supported_Countries_And_States|[object]|true|none|Array of single-key objects, one per supported VAT country. Each key is the lowercase, underscore-separated country name.|
|» **additionalProperties**|[VatCountryEntry](#vatcountryentry)|false|none|VAT country metadata: an ISO 3166-1 alpha-2 code, plus an optional map of sub-national states/regions for countries with state-level VAT (US, Canada, Spain).|
|IBAN_Supported_Countries|[[IbanCountryEntry](#ibancountryentry)]|true|none|Array of countries supported by the IBAN Validation API.|
|SWIFT_Supported_Countries|[[SwiftCountryEntry](#swiftcountryentry)]|true|none|Array of countries supported by the SWIFT/BIC Code Lookup and Finder APIs.|

### VatCountryEntry

VAT country metadata: an ISO 3166-1 alpha-2 code, plus an optional map of sub-national states/regions for countries with state-level VAT (US, Canada, Spain).

#### Properties

|Name|Type|Required|Restrictions|Description|
|---|---|---|---|---|
|code|string|true|none|ISO 3166-1 alpha-2 country code, lowercase.|
|states|object|false|none|Map of state/region name to its combined country:state code. Only present for countries with sub-national VAT rates.|
|» StateCode|string|false|none|Combined country:state identifier (e.g. us:ca).|

### IbanCountryEntry

A single country supported by the IBAN Validation API.

#### Properties

|Name|Type|Required|Restrictions|Description|
|---|---|---|---|---|
|countryCode|string|true|none|ISO 3166-1 alpha-2 country code.|
|name|string|true|none|Full country name.|

### SwiftCountryEntry

A single country supported by the SWIFT/BIC Code Lookup and Finder APIs.

#### Properties

|Name|Type|Required|Restrictions|Description|
|---|---|---|---|---|
|name|string|true|none|Full country name.|
|countryCode|string|true|none|ISO 3166-1 alpha-2 country code.|