> 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/guests/retrieve-guests-information.md).

# Retrieve Guests information

<mark style="color:green;">`GET`</mark> `/guests/{{guest_id}}`

"Retrieve Guest" endpoint is used to access detailed information about a specific guest, identified by their unique ID. This functionality is crucial for viewing comprehensive guest profiles, including personal details, contact information, and any associated reservation data

**Headers**

| Name          | Value              |
| ------------- | ------------------ |
| Content-Type  | `application/json` |
| Authorization | `JWT <token>`      |

**Query Parameters (optional)**

| Name       | Type | Description                                                                                                                                              |
| ---------- | ---- | -------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `consents` | enum | Consent readback mode. Omitted, the agreement clauses come back with the guest's current decision; `history` returns every consent event chronologically |

### All the guests of a reservation

To get every guest of a reservation in one response, call the collection instead, with no `guest_id` in the path:

<mark style="color:green;">`GET`</mark> `/guests/?guest_group_id={{guest_group_id}}`

| Name             | Type | Description                                                                                                                                                                |
| ---------------- | ---- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `guest_group_id` | uuid | <mark style="color:red;">Mandatory</mark> on this endpoint. Guest group ID of the reservation; the response contains the data of all its guests. Omitting it returns `400` |

`consents` works here too.

{% openapi src="/files/2YNWdcD7SWYAbJN2lC4R" path="/guests/{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 %}