Skip to main content
GET
/
v1
/
countries
List Generic Country Codes
curl --request GET \
  --url https://sandbox.api.fin.com/v1/countries \
  --header 'Authorization: Bearer <token>'
{
  "data": {
    "pagination": {
      "current_page": 1,
      "per_page": 20,
      "total_page": 13,
      "total": 248
    },
    "countries": [
      {
        "code": "AFG",
        "name": "Afghanistan",
        "currency_code": "AFN",
        "phone_code": "+93",
        "flag_url": "https://flagcdn.com/af.svg",
        "postal_code": {
          "required": true,
          "regex": "\\A\\d{4}\\Z"
        }
      },
      {
        "code": "ALA",
        "name": "Åland Islands",
        "currency_code": "EUR",
        "phone_code": "+358",
        "flag_url": "https://flagcdn.com/ax.svg",
        "postal_code": {
          "required": true,
          "regex": "\\A22\\d{3}\\Z"
        }
      },
      {
        "code": "ALB",
        "name": "Albania",
        "currency_code": "ALL",
        "phone_code": "+355",
        "flag_url": "https://flagcdn.com/al.svg",
        "postal_code": {
          "required": true,
          "regex": "\\A\\d{4}\\Z"
        }
      },
      {
        "code": "DZA",
        "name": "Algeria",
        "currency_code": "DZD",
        "phone_code": "+213",
        "flag_url": "https://flagcdn.com/dz.svg",
        "postal_code": {
          "required": true,
          "regex": "\\A\\d{5}\\Z"
        }
      },
      {
        "code": "ASM",
        "name": "American Samoa",
        "currency_code": "USD",
        "phone_code": "+1-684",
        "flag_url": "https://flagcdn.com/as.svg",
        "postal_code": {
          "required": true,
          "regex": "\\A(96799)(?:[ \\-](\\d{4}))?\\Z"
        }
      },
      {
        "code": "AND",
        "name": "Andorra",
        "currency_code": "EUR",
        "phone_code": "+376",
        "flag_url": "https://flagcdn.com/ad.svg",
        "postal_code": {
          "required": true,
          "regex": "\\AAD[1-7]0\\d\\Z"
        }
      },
      {
        "code": "AGO",
        "name": "Angola",
        "currency_code": "AOA",
        "phone_code": "+244",
        "flag_url": "https://flagcdn.com/ao.svg",
        "postal_code": {
          "required": false,
          "regex": null
        }
      },
      {
        "code": "AIA",
        "name": "Anguilla",
        "currency_code": "XCD",
        "phone_code": "+1-264",
        "flag_url": "https://flagcdn.com/ai.svg",
        "postal_code": {
          "required": true,
          "regex": "\\A(?:AI-)?2640\\Z"
        }
      },
      {
        "code": "ATA",
        "name": "Antarctica",
        "flag_url": "https://flagcdn.com/aq.svg",
        "postal_code": {
          "required": false,
          "regex": null
        }
      },
      {
        "code": "ATG",
        "name": "Antigua and Barbuda",
        "currency_code": "XCD",
        "phone_code": "+1-268",
        "flag_url": "https://flagcdn.com/ag.svg",
        "postal_code": {
          "required": false,
          "regex": null
        }
      },
      {
        "code": "ARG",
        "name": "Argentina",
        "currency_code": "ARS",
        "phone_code": "+54",
        "flag_url": "https://flagcdn.com/ar.svg",
        "postal_code": {
          "required": true,
          "regex": "\\A((?:[A-HJ-NP-Z])?\\d{4})([A-Z]{3})?\\Z"
        }
      },
      {
        "code": "ARM",
        "name": "Armenia",
        "currency_code": "AMD",
        "phone_code": "+374",
        "flag_url": "https://flagcdn.com/am.svg",
        "postal_code": {
          "required": true,
          "regex": "\\A(?:37)?\\d{4}\\Z"
        }
      },
      {
        "code": "ABW",
        "name": "Aruba",
        "currency_code": "AWG",
        "phone_code": "+297",
        "flag_url": "https://flagcdn.com/aw.svg",
        "postal_code": {
          "required": false,
          "regex": null
        }
      },
      {
        "code": "AUS",
        "name": "Australia",
        "currency_code": "AUD",
        "phone_code": "+61",
        "flag_url": "https://flagcdn.com/au.svg",
        "postal_code": {
          "required": true,
          "regex": "\\A\\d{4}\\Z"
        }
      },
      {
        "code": "AUT",
        "name": "Austria",
        "currency_code": "EUR",
        "phone_code": "+43",
        "flag_url": "https://flagcdn.com/at.svg",
        "postal_code": {
          "required": true,
          "regex": "\\A\\d{4}\\Z"
        }
      },
      {
        "code": "AZE",
        "name": "Azerbaijan",
        "currency_code": "AZN",
        "phone_code": "+994",
        "flag_url": "https://flagcdn.com/az.svg",
        "postal_code": {
          "required": true,
          "regex": "\\A\\d{4}\\Z"
        }
      },
      {
        "code": "BHS",
        "name": "Bahamas",
        "currency_code": "BSD",
        "phone_code": "+1-242",
        "flag_url": "https://flagcdn.com/bs.svg",
        "postal_code": {
          "required": false,
          "regex": null
        }
      },
      {
        "code": "BHR",
        "name": "Bahrain",
        "currency_code": "BHD",
        "phone_code": "+973",
        "flag_url": "https://flagcdn.com/bh.svg",
        "postal_code": {
          "required": true,
          "regex": "\\A(?:\\d|1[0-2])\\d{2}\\Z"
        }
      },
      {
        "code": "BGD",
        "name": "Bangladesh",
        "currency_code": "BDT",
        "phone_code": "+880",
        "flag_url": "https://flagcdn.com/bd.svg",
        "postal_code": {
          "required": true,
          "regex": "\\A\\d{4}\\Z"
        }
      },
      {
        "code": "BRB",
        "name": "Barbados",
        "currency_code": "BBD",
        "phone_code": "+1-246",
        "flag_url": "https://flagcdn.com/bb.svg",
        "postal_code": {
          "required": true,
          "regex": "\\ABB\\d{5}\\Z"
        }
      }
    ]
  }
}
Retrieve a list of country specific codes following ISO 3166-1 alpha-3 standard.

Authorizations

Authorization
string
header
required

Bearer token authentication. Obtain token from Issue a Token endpoint

Query Parameters

per_page
integer
default:10

Number of items to return per page

Required range: 1 <= x <= 512
current_page
integer
default:1

The page number to retrieve

Required range: x >= 1

Response

List of countries retrieved successfully

data
object