---
title: "List countries"
method: GET
path: "/countries"
tags: ["Countries"]
---

# List countries

`GET /countries`

## Request

- Base URL: `https://api.faireplace.com/api`
- URL: `https://api.faireplace.com/api/countries`
- Auth: HTTP bearer

Lists all **active** countries available as reference data.

Countries are global reference entries used for ISO code lookups,
rent regulation resolution and address normalization.

## Usage Example

```bash
curl -X GET https://api.faireplace.com/api/countries \
  -H "Authorization: Bearer YOUR_API_KEY"
```

**Response**:
```json
[
  {
    "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"
  }
]
```

## Response `200`

List of active countries.

- Country[]: List of country reference entries.
  - `id` string, uuid, required: Unique country identifier.
  - `code` string, required: ISO country code (typically ISO 3166-1 alpha-2, e.g. `FR`, `BE`, `DE`).
  - `name` string, required: Human-readable country name.
  - `is_active` boolean, required: Whether the country is active. The `GET /countries` list endpoint returns only active countries.
  - `created_at` string, date-time, required: Creation timestamp (ISO 8601).
  - `updated_at` string, date-time, required: Last update timestamp (ISO 8601).

## Other responses

- `401`: Unauthorized
- `403`: Forbidden
- `500`: Internal Server Error

---

[API](https://skmtc.dev/faireplace/apis/faireplace-property-management-api.md) · [All operations](https://skmtc.dev/faireplace/apis/faireplace-property-management-api/llms.txt) · [OpenAPI document](https://skmtc.dev/faireplace/apis/faireplace-property-management-api/revisions/69de39762919?raw)