Country

About

ISO 3166-1Wikipedia

One Record API uses ISO 3166 codes to provide a standardized representation of a country. The country is identified by the two-letter code (e.g. "FR" for France), while places are identified by a three-letter code (e.g. for airports, their IATA three-letter location identifier code such as “LAX” for Los Angeles International Airport), ensuring uniformity and accuracy in international data exchanges, geographic information systems, and various applications requiring precise identification of countries and places. For countries or territories not officially recognized, the X code is used, e.g. XK for Kosovo.

Endpoints

Everyone can view these resources

Get all countries

get

Get all countries

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

/country

HTTPcURLJavaScriptPython

GET /country HTTP/1.1
Host: api.one-record.fr
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

{
  "data": [
    {
      "code": "AD",
      "name": "text",
      "code3": "text",
      "codeNumeric": "text",
      "region": "Europe",
      "createdAt": null,
      "updatedAt": null
    }
  ],
  "metadata": {
    "count": 1,
    "current": "text",
    "next": "text"
  }
}

Get a country

get

Get a country

Authorizations

bearer

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Path parameters

codestringRequired

Responses

200Success

application/json

codestring · enumRequiredPossible values:

namestring · max: 70Required

code3string · nullableRequired

codeNumericstring · nullableRequired

regionstring · enum · nullableRequiredPossible values:

createdAtanyOptional

updatedAtany · nullableOptional

400

Bad Request

application/json

401

Unauthorized Entity

application/json

422

Unprocessable Entity

application/json

get

/country/{code}

HTTPcURLJavaScriptPython

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

{
  "code": "AD",
  "name": "text",
  "code3": "text",
  "codeNumeric": "text",
  "region": "Europe",
  "createdAt": null,
  "updatedAt": null
}