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"
}
}
]
}
}All Catalogues
List Generic Country Codes
Retrieve a list of country specific codes following ISO 3166-1 alpha-3 standard
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
Bearer token authentication. Obtain token from Issue a Token endpoint
Query Parameters
Number of items to return per page
Required range:
1 <= x <= 512The page number to retrieve
Required range:
x >= 1Response
List of countries retrieved successfully
Show child attributes
Show child attributes
⌘I
