---
title: "List Global Cities Directory records"
method: GET
path: "/v1/data/global-cities-directory"
tags: ["Cities"]
---

# List Global Cities Directory records

`GET /v1/data/global-cities-directory`

## 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/global-cities-directory`
- Auth: none declared. Required headers: `X-API-Key`

List Global Cities Directory records with optional filters and pagination.

**Source:** Data from GeoNames (geonames.org) via the datasets/world-cities project, licensed CC BY 4.0 (CC BY 4.0).

**Fields returned:**
- `geonameid` (int) — GeoNames unique identifier for the city
- `name` (str) — City name
- `country` (str) — Country name
- `subcountry` (str) — State, province or region

**Example:** `GET /v1/data/global-cities-directory?limit=10&country=example`

## Query parameters

- `limit` integer: Max records to return (1-100).
- `offset` integer: Records to skip, for pagination.
- `country` string, nullable: Country name
- `subcountry` string, nullable: State, province or region

## Headers

- `X-API-Key` string, required

## Response `200`

A page of Global Cities Directory records with pagination metadata.

- unknown

## Other responses

- `422`: Validation Error

---

[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)