Skip to main content
GET
/
v1
/
contacts
/
{id}
/
reservations
List reservations for a contact
curl --request GET \
  --url https://api.conduit.ai/v1/contacts/{id}/reservations \
  --header 'Authorization: Bearer <token>'
{
  "data": [
    {
      "id": "rs77c0dy0mgdpzmqz6tesry8w184002s",
      "workspace_id": "j57demo8f8x7c9v0n2q4r6t8y1u3i5o",
      "contact_id": "ph77c0dy0mgdpzmqz6tesry8w184002s",
      "listing_id": "12345",
      "pms_platform": "hostaway",
      "external_id": "39487305",
      "channel_name": "Airbnb",
      "channel_reservation_id": "HMABCXYZ",
      "confirmation_code": "HMABCXYZ",
      "status": "confirmed",
      "source": "airbnb",
      "arrival_date": "2026-05-01",
      "arrival_at": "2026-05-01T15:00:00.000Z",
      "departure_date": "2026-05-05",
      "departure_at": "2026-05-05T11:00:00.000Z",
      "num_nights": 4,
      "number_of_guests": 2,
      "number_of_adults": 2,
      "number_of_children": 0,
      "number_of_infants": 0,
      "number_of_pets": 0,
      "guest": {
        "name": "Taylor Reid",
        "first_name": "Taylor",
        "last_name": "Reid",
        "email": "taylor.reid@example.com",
        "phone": "+14155550123",
        "country": "US",
        "city": "San Francisco",
        "locale": "en",
        "external_account_id": "airbnb_user_789"
      },
      "payment": {
        "is_paid": true,
        "total_price": 920.5,
        "currency": "USD",
        "outstanding_balance": 0
      },
      "door_code": null,
      "key_code": null,
      "guest_note": null,
      "ai_paused": false,
      "created_at": "2026-04-18T17:20:00.000Z",
      "updated_at": "2026-04-18T17:20:00.000Z"
    }
  ],
  "next_cursor": "page-token",
  "has_more": true
}

Authorizations

​
Authorization
string
header
required

Conduit API token. Use Authorization: Bearer <token>. Read/write endpoints require a token with write access.

Path Parameters

​
id
string
required

Contact id.

Example:

"ph77c0dy0mgdpzmqz6tesry8w184002s"

Query Parameters

​
workspace_id
string

Optional workspace override. If omitted, Conduit resolves the contact's workspace automatically.

Example:

"j57demo8f8x7c9v0n2q4r6t8y1u3i5o"

​
limit
integer

Page size. Defaults to 20. Max 100.

Required range: 1 <= x <= 100
​
cursor
string
​
order
enum<string>

Sort direction. Defaults to desc.

Available options:
asc,
desc
​
sort_by
enum<string>

Primary sort field. arrival sorts by check-in date, departure by check-out date, created by booking creation time. Defaults to arrival.

Available options:
arrival,
departure,
created
​
status
string

Filter by reservation status. Values are PMS-normalized and vary by integration (common examples: confirmed, cancelled, inquiry, new).

Example:

"confirmed"

Response

Contact reservations

Cursor-paginated reservations response.

​
data
object[]
required
​
next_cursor
string | null
required
​
has_more
boolean
required