GET /guests - RecepAI

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.

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)

{
  "guests": [
    {
      "pmsGuestId": "RES-2026-001",
      "firstName": "John",
      "lastName": "Doe",
      "roomNumber": "301",
      "checkInDate": "2026-02-18",
      "checkOutDate": "2026-02-22",
      "phone": "+905551234567",
      "language": "en",
      "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",
      "language": "de",
      "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`)
`language`	string	ISO 639-1 language code (may be `null` if not provided at check-in)
`source`	string	Always `"pms"` for guests created through this API
`createdAt`	string	Timestamp when the guest was checked in (ISO 8601)

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.

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, compare your current guest list with what RecepAI has

Example: cURL

curl -X GET https://app.recepai.ai/api/pms/v1/grand-hotel/guests \
  -H "Authorization: Bearer pms_live_a1b2c3d4e5f6g7h8i9j0k1l2m3n4o5p6"