Place

About

The Place Code system employs a standardized three-letter abbreviation to ensure consistent and accurate identification of specific locations, including cities, towns, and significant landmarks across the globe.

Each code, consisting of three alphabetical letters (e.g., "NYC" for New York City), facilitates uniformity in international data exchanges, geographic information systems, and various applications that necessitate precise location identification.

This system aids in streamlining communication and data processing by providing a concise, universally recognized format for referencing a wide range of geographic entities, thereby enhancing efficiency in global logistics, travel planning, and international commerce.

One Record API uses the IATA three-letter location identifier to identify airports. E.g. Tokyo-Narita International Airport will be identified by NRT.

To avoid confusion, a country will be identified by a two-letter code.

Groups

To understand the groups parameter and the customization of API responses, please refer to the groups page.

List of groups

  • country - to retrieve information about the country.

Endpoints

Everyone can view these resources

Get all places

get

Get all places

Authorizations
Query parameters
page[cursor]stringOptional
page[limit]any · min: 2 · max: 200Optional
order[column]stringOptionalExample: column_name
order[direction]stringOptionalExample: asc|desc
Responses
200Success
application/json
get
GET /place HTTP/1.1
Host: api.one-record.fr
Authorization: Bearer JWT
Accept: */*

{
  "data": [
    {
      "code": "text",
      "country": "AD",
      "name": "text",
      "icao": "text",
      "state": "text",
      "latitude": 1,
      "longitude": 1,
      "timezone": "text",
      "type": "airport",
      "createdAt": null,
      "updatedAt": null
    }
  ],
  "metadata": {
    "count": 1,
    "current": "text",
    "next": "text"
  }
}

Get a place

get

Get a place

Authorizations
Path parameters
codestringRequired
Responses
200Success
application/json
get
GET /place/{code} HTTP/1.1
Host: api.one-record.fr
Authorization: Bearer JWT
Accept: */*

{
  "code": "text",
  "country": "AD",
  "name": "text",
  "icao": "text",
  "state": "text",
  "latitude": 1,
  "longitude": 1,
  "timezone": "text",
  "type": "airport",
  "createdAt": null,
  "updatedAt": null
}
PreviousCountryNextShipment

Last updated