---
title: "List Generic Country Codes"
method: GET
path: "/v1/countries"
tags: ["Catalogue"]
---

# List Generic Country Codes

`GET /v1/countries`

Retrieve a list of country specific codes following ISO 3166-1 alpha-3 standard

## Query parameters

- `per_page` integer
- `current_page` integer

## Response `200`

List of countries retrieved successfully

- object
  - `data` object
    - `pagination` Pagination
      - `current_page` integer
      - `per_page` integer
      - `total_page` integer
      - `total` integer
    - `countries` object[]
      - `code` string
      - `name` string
      - `currency_code` string
      - `phone_code` string
      - `flag_url` string, uri
      - `postal_code` object
        - `required` boolean
        - `regex` string, nullable

## Other responses

- `401` — Authentication failed due to invalid credentials

---

[API](https://skmtc.net/fin/apis/fin-com-api.md) · [All operations](https://skmtc.net/fin/apis/fin-com-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/fin/fin-com-api/revisions/6e69503ee7b8/schema)