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

bearer

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

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

400

Bad Request

application/json

401

Unauthorized Entity

application/json

422

Unprocessable Entity

application/json

get

/place

HTTPcURLJavaScriptPython

GET /place HTTP/1.1
Host: api.one-record.fr
Authorization: Bearer YOUR_SECRET_TOKEN
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

bearer

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Path parameters

codestringRequired

Responses

200Success

application/json

codestringRequired

countryone ofRequired

string · enumOptionalPossible values:

or

namestring · max: 70Required

icaostring · nullableRequired

statestring · max: 70 · nullableRequired

latitudenumber · min: -90 · max: 90 · nullableRequired

longitudenumber · min: -180 · max: 180 · nullableRequired

timezonestring · max: 70 · nullableRequired

typestring · enum · nullableRequiredPossible values:

createdAtanyOptional

updatedAtany · nullableOptional

400

Bad Request

application/json

401

Unauthorized Entity

application/json

422

Unprocessable Entity

application/json

get

/place/{code}

HTTPcURLJavaScriptPython

GET /place/{code} HTTP/1.1
Host: api.one-record.fr
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

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