> For the complete documentation index, see [llms.txt](https://chekin.gitbook.io/chekin-public-api/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://chekin.gitbook.io/chekin-public-api/api-reference/reservations/retrieve-reservations.md).

# Retrieve Reservations

The "Retrieve a Reservation" endpoint is designed to provide detailed information about a specific reservation based on its unique identifier. This is particularly useful for accessing the complete details of a booking, including guest information, stay dates, and any related statuses or links.

### Header Parameters:

* **Authorization** *(string) <mark style="color:red;">**\***</mark>**Mandatory***\
  Required for authentication and authorization. You'll need to include a valid token here to access the reservations

### Path Parameters:

* **id** *(string, format: UUID) <mark style="color:red;">**\***</mark>**Mandatory***\
  Unique identifier of the reservation. Specifies which reservation's details you're requesting

### Accommodation type

The response includes an **`accommodation_type`** field *(string)* with the type of room or apartment booked, used for INE statistics reporting in Spain. It is one of `DOUBLE_ROOM_DOUBLE_USE`, `DOUBLE_ROOM_SINGLE_USE`, `STUDIO`, `APARTMENT_2_4_PAX`, `APARTMENT_4_6_PAX`, `OTHER`, or an empty string when not set. See [Create Reservations](/chekin-public-api/api-reference/reservations/create-reservations.md#accommodation-type) for the meaning of each value.

### Error details

The response includes an **`error_details`** object that explains *why* a compliance status failed, complementing the status values in `detailed_statuses`. It always contains these five keys, each an object with `message` and `code`:

* `police_pre_checkin` — Spanish police reservation report (pairs with `police_booking_check_in_status`)
* `police_check_in` — police guest check-in report (pairs with `police_check-in`)
* `police_check_out` — police guest check-out report (pairs with `police_check-out`)
* `stats_check_in` — statistics check-in report (pairs with `stat_check_in_status`)
* `stats_check_out` — statistics check-out report (pairs with `stat_check_out_status`)

For each key:

* `message` *(string or null)* — the error as plain, human-readable text. It is never a serialised object. The text is usually in the authority's language, followed by the English version in brackets. It is `null` when the status is not in error, and also when no readable text is available for the error.
* `code` *(string or null)* — the error code, prefixed by provider (e.g. `SES0018`, `ISTAT0003`). It is `null` when the status is not in error. Some errors have no code assigned, so treat it as optional.

The object and all five keys are always present. `police_check_out` only applies to police integrations that process check-outs and is `null` otherwise.

```json
"error_details": {
  "police_pre_checkin": { "message": null, "code": null },
  "police_check_in": {
    "message": "Credenciales no válidas. Revisa y actualiza las credenciales en Chekin en Property → Legal → Police Connection y vuelve a intentarlo. (Invalid credentials. Check and update the credentials in Chekin under Property → Legal → Police Connection and try again.)",
    "code": "SES0018"
  },
  "police_check_out": { "message": null, "code": null },
  "stats_check_in": {
    "message": "Credenziali ISTAT non valide o autorizzazione insufficiente. Verifica o aggiorna i dati ISTAT in Property - Legal - Statistics e riprova (Invalid ISTAT credentials or insufficient authorization. Check or update ISTAT details in under Property - Legal - Statistics and try again).",
    "code": "ISTAT0003"
  },
  "stats_check_out": { "message": null, "code": null }
}
```

{% openapi src="/files/2YNWdcD7SWYAbJN2lC4R" path="/reservations/{id}" method="get" %}
[Chekin-Chekin-1.0.0-resolved.json](https://3564732132-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FfAJzL2tAGO9ZwOToBa0R%2Fuploads%2Fgit-blob-0641a0e07e27281f11fe82de446c7229bfe15c1e%2FChekin-Chekin-1.0.0-resolved.json?alt=media)
{% endopenapi %}