Countries

Get a country by ISO code

Retrieves a single country by its ISO code (e.g. FR).

curl -X GET https://api.faireplace.com/api/countries/code/FR \
  -H "Authorization: Bearer YOUR_API_KEY"
get/countries/code/{code}

Request

  • Base URL: https://api.faireplace.com/api
  • URL: https://api.faireplace.com/api/countries/code/{code}
  • Auth: HTTP bearer

Path parameters

codestring required

ISO country code (e.g. FR, BE, DE).

Response

The country.

idstring uuid required

Unique country identifier.

codestring required

ISO country code (typically ISO 3166-1 alpha-2, e.g. FR, BE, DE).

namestring required

Human-readable country name.

is_activeboolean required

Whether the country is active.

The GET /countries list endpoint returns only active countries.

created_atstring date-time required

Creation timestamp (ISO 8601).

updated_atstring date-time required

Last update timestamp (ISO 8601).

Example response

{
  "id": "550e8400-e29b-41d4-a716-446655440000",
  "code": "FR",
  "name": "France",
  "is_active": true,
  "created_at": "2026-01-15T09:00:00",
  "updated_at": "2026-01-15T09:00:00"
}

Changes

No recorded changes to this operation across all 1 revision of this API.