---
title: "List Countries"
method: GET
path: "/v1/countries"
tags: ["Country"]
---

# List Countries

`GET /v1/countries`

## Request

- Base URL: `https://api.monime.io`
- URL: `https://api.monime.io/v1/countries`
- Auth: HTTP bearer

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

## Query parameters

- `limit` integer: Maximum number of items to return in a single page. Must be between 1 and 50. Defaults to 10 if not specified.
- `after` string, nullable: Pagination cursor for fetching the next page of results. Set this to the 'next' cursor value from a previous response to continue paginating forward.

## Headers

- `Monime-Version` 'caph.2025-08-23' | 'caph.2025-06-20', nullable: Specifies which version of the Monime API will handle this request.

## Response `200`

OK

- object
  - `success` boolean: Represents the status of the query operation, confirming if it was successful. This field is always true
  - `messages` unknown[]: Contains a list of messages providing relevant information or feedback related to the query or operation
    - unknown
  - `result` Country[], nullable: The list of items in the response
    - `code` string: The ISO 3166-1 alpha-2 country code.
    - `name` string: The name of the country.
    - `currency` object: The default currency object of the country.
      - `code` string: The [3-letter](https://en.wikipedia.org/wiki/ISO_4217) ISO currency code.
      - `unit` string: The subunit for the currency.
      - `unitLength` integer: The unit length for the currency's subunit.
    - `supportedCurrencies` string[], nullable: The list supported currency codes in ISO 4217 format in that country. It includes the default currency's code.
  - `pagination` object: The pagination info associated with the response
    - `count` integer: Number of items returned in the current page.
    - `next` string, nullable: 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.

## Changes

- **2026-11-03** `fd6fd8884fef`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/monime/apis/monime-api/changes/v1/countries/get.md)

---

[API](https://skmtc.dev/monime/apis/monime-api.md) - [All operations](https://skmtc.dev/monime/apis/monime-api/llms.txt) - [OpenAPI document](https://skmtc.dev/monime/apis/monime-api/revisions/fd6fd8884fef?raw)