List Countries

Retrieves a list of supported countries available in the Monime platform. Useful for onboarding flows, address validation, or region-based payment configurations.

GET /v1/countries

Try it

List Countries

cURL

curl --request GET \
  --url https://api.monime.io/v1/countries \
  --header 'Authorization: Bearer <token>'

200

{
  "success": true,
  "messages": [
    "<unknown>"
  ],
  "result": [
    {
      "code": "SL",
      "name": "Sierra Leone",
      "currency": {
        "code": "SLE",
        "unit": "cent",
        "unitLength": 2
      },
      "supportedCurrencies": [
        "SLE"
      ]
    }
  ],
  "pagination": {
    "count": 123,
    "next": "<string>"
  }
}

Authorizations

Authorization · string · header · required

Bearer HTTP authentication specified with the header Authorization: Bearer <access_token>

Headers

Monime-Version · enum<string> | null

Specifies which version of the Monime API will handle this request. Specifies which version of the Monime API will handle this request.

Available options: caph.2025-08-23, caph.2025-06-20

Query Parameters

limit · integer · default: 10

Maximum number of items to return in a single page. Must be between 1 and 50. Defaults to 10 if not specified. Maximum number of items to return in a single page. Must be between 1 and 50. Defaults to 10 if not specified.

Required range: 1 <= x <= 50

after · string | null

Pagination cursor for fetching the next page of results. Set this to the 'next' cursor value from a previous response to continue paginating forward. Pagination cursor for fetching the next page of results. Set this to the 'next' cursor value from a previous response to continue paginating forward.

Maximum string length: 2000

Response

200 - application/json

OK

success · boolean

Represents the status of the query operation, confirming if it was successful. This field is always true

messages · any[]

Contains a list of messages providing relevant information or feedback related to the query or operation

result · Country · object[] | null

The list of items in the response

Show child attributes

result. code · string

The ISO 3166-1 alpha-2 country code.

Example:

"SL"

result. name · string

The name of the country.

Example:

"Sierra Leone"

result. currency · object

The default currency object of the country.

Show child attributes

result.currency. code · string

The 3-letter ISO currency code.

Example:

"SLE"

result.currency. unit · string

The subunit for the currency.

Example:

"cent"

result.currency. unitLength · integer

The unit length for the currency's subunit.

Example:

2

result. supportedCurrencies · string[] | null

The list supported currency codes in ISO 4217 format in that country. It includes the default currency's code.

Example:

["SLE"]

pagination · object

The pagination info associated with the response

Show child attributes

pagination. count · integer

Number of items returned in the current page.

pagination. next · string | null

Cursor pointing to the next page of results. Use this value as the 'after' query parameter in your next request to fetch the following page. If null, you have reached the end of the result set.