Docs/Channels/Airbnb

Airbnb Reservations

List, get, accept, decline, and cancel Airbnb reservations. Includes price breakdown and full guest details. Cursor-paginated like every other list endpoint — walk pages with `?cursor=<pagination.nextCursor>` until `pagination.hasMore` is `false`.

GET/v1/channels/airbnb/reservations

Parameters

cursorstring

Opaque cursor from the previous response's `pagination.nextCursor`. Omit for the first page.

limitinteger

Max items per page. Default 50, max 100.

listing_idstring

Filter to one Airbnb listing id.

statusstring

Filter by status (`pending`, `accepted`, `denied`, `cancelled`, `completed`, `failed_verification`, `request_voided`). Omit to receive all statuses.

start_datestring

ISO 8601 (YYYY-MM-DD) lower bound on the date range filter.

end_datestring

ISO 8601 (YYYY-MM-DD) upper bound on the date range filter.

Example

# Page 1 (default 50)
curl 'https://api.repull.dev/v1/channels/airbnb/reservations?limit=50' \
  -H "Authorization: Bearer sk_test_YOUR_KEY"

# Walk to page 2 with the cursor returned by page 1
curl 'https://api.repull.dev/v1/channels/airbnb/reservations?limit=50&cursor=eyJ1IjoiWDE5...' \
  -H "Authorization: Bearer sk_test_YOUR_KEY"

# Filter to one listing's reservations within a date window
curl 'https://api.repull.dev/v1/channels/airbnb/reservations?listing_id=18871326&start_date=2026-06-01&end_date=2026-08-31' \
  -H "Authorization: Bearer sk_test_YOUR_KEY"

# Accept a pending reservation
curl -X POST https://api.repull.dev/v1/channels/airbnb/reservations/HMA1234567 \
  -H "Authorization: Bearer sk_test_YOUR_KEY" \
  -d '{"action": "accept"}'

Response

{
  "data": [
    {
      "confirmationCode": "HMABC12345",
      "statusType": "accept",
      "listingId": "18871326",
      "startDate": "2026-07-06",
      "endDate": "2026-07-08",
      "nights": 2,
      "guestFirstName": "Nowf",
      "guestLastName": "Abugauch",
      "hostCurrency": "CAD",
      "payoutAmount": "750.74"
    }
  ],
  "pagination": {
    "nextCursor": "eyJ1IjoiWDE5MmFXRmtkV04wT21sa2VEb3oifQ",
    "hasMore": true
  }
}

Previous← Guest Messaging NextReviews →