> ## Documentation Index
> Fetch the complete documentation index at: https://docs.recepai.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# GET /guests

> Retrieve all currently in-house guests pushed by your PMS.

## Endpoint

```
GET https://app.recepai.ai/api/pms/v1/{slug}/guests
```

Returns all currently in-house guests that were created through the PMS API. This endpoint is useful for verification, debugging, and reconciliation before running a [full sync](/api/pms/sync).

## Headers

| Header          | Required | Description                                    |
| --------------- | -------- | ---------------------------------------------- |
| `Authorization` | Yes      | `Bearer pms_live_xxx` or `Bearer pms_test_xxx` |

No request body. No `Idempotency-Key` required (this is a GET request).

## Response: Success (200)

```json theme={null}
{
  "guests": [
    {
      "pmsGuestId": "RES-2026-001",
      "firstName": "John",
      "lastName": "Doe",
      "roomNumber": "301",
      "checkInDate": "2026-02-18",
      "checkOutDate": "2026-02-22",
      "phone": "+905551234567",
      "source": "pms",
      "createdAt": "2026-02-18T14:00:00Z"
    },
    {
      "pmsGuestId": "RES-2026-002",
      "firstName": "Maria",
      "lastName": "Garcia",
      "roomNumber": "405",
      "checkInDate": "2026-02-16",
      "checkOutDate": "2026-02-20",
      "phone": "+491234567890",
      "source": "pms",
      "createdAt": "2026-02-16T10:30:00Z"
    }
  ],
  "count": 2,
  "requestId": "req_q7r8s9t0"
}
```

## Guest Object Fields

| Field          | Type   | Description                                                  |
| -------------- | ------ | ------------------------------------------------------------ |
| `pmsGuestId`   | string | Your PMS's identifier for this guest                         |
| `firstName`    | string | Guest first name (may be `null` if not provided at check-in) |
| `lastName`     | string | Guest last name                                              |
| `roomNumber`   | string | Current room number                                          |
| `checkInDate`  | string | Check-in date (`YYYY-MM-DD`)                                 |
| `checkOutDate` | string | Expected checkout date (`YYYY-MM-DD`)                        |
| `phone`        | string | Phone number in E.164 format (may be `null`)                 |
| `source`       | string | Always `"pms"` for guests created through this API           |
| `createdAt`    | string | Timestamp when the guest was checked in (ISO 8601)           |

<Note>
  **PMS guests only.** This endpoint only returns guests with `source: "pms"` — guests that were created through the PMS API. Guests entered manually by hotel staff are not included. This ensures your PMS sees only the data it manages.
</Note>

## Use Cases

* **Verification:** After a series of check-ins, confirm all guests were recorded correctly
* **Debugging:** If a guest is missing from the hotel dashboard, check if the PMS API received the check-in
* **Pre-sync check:** Before running a [full sync](/api/pms/sync), compare your current guest list with what RecepAI has

## Example: cURL

```bash theme={null}
curl -X GET https://app.recepai.ai/api/pms/v1/grand-hotel/guests \
  -H "Authorization: Bearer pms_live_a1b2c3d4e5f6g7h8i9j0k1l2m3n4o5p6"
```