---
title: "List Country Calling Codes records"
method: GET
path: "/v1/data/country-calling-codes"
tags: ["Utilities"]
---

# List Country Calling Codes records

`GET /v1/data/country-calling-codes`

## Request

- Base URL: `https://api.aristocles.com.au` (the document declares no server; this is the origin it was published from)
- URL: `https://api.aristocles.com.au/v1/data/country-calling-codes`
- Auth: none declared. Required headers: `X-API-Key`

List Country Calling Codes records with optional filters and pagination.

**Source:** DataHub.io, country-codes (ODbL).

**Fields returned:**
- `country_name` (str) — The commonly used name of the country.
- `iso2` (str) — The 2-letter ISO 3166-1 alpha-2 country code.
- `iso3` (str) — The 3-letter ISO 3166-1 alpha-3 country code.
- `calling_code` (str) — The international dialling prefix for the country (e.g., '61' for Australia).
- `continent` (str) — The two-letter continent code (e.g., OC for Oceania).

**Example:** `GET /v1/data/country-calling-codes?limit=10&continent=example`

## Query parameters

- `limit` integer: Max records to return (1-100).
- `offset` integer: Records to skip, for pagination.
- `continent` string, nullable: The two-letter continent code (e.g., OC for Oceania).

## Headers

- `X-API-Key` string, required

## Response `200`

A page of Country Calling Codes records with pagination metadata.

- unknown

## Other responses

- `422`: Validation Error

## Changes

- **2026-10-19** `4ca3fbb73c59`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/aristocles/apis/aristocles-data-api/changes/v1/data/country-calling-codes/get.md)

---

[API](https://skmtc.dev/aristocles/apis/aristocles-data-api.md) · [All operations](https://skmtc.dev/aristocles/apis/aristocles-data-api/llms.txt) · [OpenAPI document](https://skmtc.dev/aristocles/apis/aristocles-data-api/revisions/4ca3fbb73c59?raw)