Skip to main content
GET
/
v1
/
countries
cURL
curl --request GET \
  --url https://{base_url}/v1/countries \
  --header 'Authorization: <authorization>'
{
  "data": {
    "pagination": {
      "current_page": 1,
      "per_page": 10,
      "total_page": 25,
      "total": 246
    },
    "countries": [
      {
        "code": "AFG",
        "name": "Afghanistan",
        "currency_code": "AFN",
        "phone_code": "+93",
        "flag_url": "https://flagcdn.com/af.svg"
      },
      {
        "code": "ALB",
        "name": "Albania",
        "currency_code": "ALL",
        "phone_code": "+355",
        "flag_url": "https://flagcdn.com/al.svg"
      },
      {
        "code": "DZA",
        "name": "Algeria",
        "currency_code": "DZD",
        "phone_code": "+213",
        "flag_url": "https://flagcdn.com/dz.svg"
      },
      {
        "code": "ASM",
        "name": "American Samoa",
        "currency_code": "USD",
        "phone_code": "+1-684",
        "flag_url": "https://flagcdn.com/as.svg"
      },
      {
        "code": "AND",
        "name": "Andorra",
        "currency_code": "EUR",
        "phone_code": "+376",
        "flag_url": "https://flagcdn.com/ad.svg"
      },
      {
        "code": "AGO",
        "name": "Angola",
        "currency_code": "AOA",
        "phone_code": "+244",
        "flag_url": "https://flagcdn.com/ao.svg"
      },
      {
        "code": "AIA",
        "name": "Anguilla",
        "currency_code": "XCD",
        "phone_code": "+1-264",
        "flag_url": "https://flagcdn.com/ai.svg"
      },
      {
        "code": "ATA",
        "name": "Antarctica",
        "flag_url": "https://flagcdn.com/aq.svg"
      },
      {
        "code": "ATG",
        "name": "Antigua and Barbuda",
        "currency_code": "XCD",
        "phone_code": "+1-268",
        "flag_url": "https://flagcdn.com/ag.svg"
      },
      {
        "code": "ARG",
        "name": "Argentina",
        "currency_code": "ARS",
        "phone_code": "+54",
        "flag_url": "https://flagcdn.com/ar.svg"
      }
    ]
  }
}

Documentation Index

Fetch the complete documentation index at: https://developer.fin.com/llms.txt

Use this file to discover all available pages before exploring further.

Headers

Authorization
string
default:Bearer {{client_access_token}}
required

Query Parameters

per_page
number
default:10
required

By default 10

current_page
string
default:1
required

By default starts from 1

Response

200 - application/json

OK

data
object