---
title: "List reservations"
method: GET
path: "/reservations"
---

# List reservations

`GET /reservations`

## Request

- Base URL: `https://platform-api.visitoai.com/m2m/v1`
- URL: `https://platform-api.visitoai.com/m2m/v1/reservations`
- Auth: HTTP bearer

Requires `reservations:read`. Mirrored provider reservations, not live availability. Fixed page size 20. Continue nextCursor while hasNext is true with the same filters and sorting.

## Query parameters

- `integrationId` string
- `cursor` string
- `reservationId` string
- `status` string
- `sortBy` 'check_in_date' | 'booked_at'
- `sortDir` 'asc' | 'desc'

## Response `200`

Success

- ReservationMirrorDiagnosticsResponse
  - `mirrors` object[], required
    - `attempts` object[], required
      - `createdAt` string, required
      - `lifecycleEventType` union, required
        - 'booking_confirmed'
        - 'pre_checkin'
        - 'post_checkout_review'
      - `result` union, required
        - 'would_send'
        - 'deferred'
        - 'skipped'
        - 'invalid'
        - 'duplicate'
        - 'error'
      - `reason` string, required
      - `attemptCount` number, required
      - `duplicateCount` number, required
      - `triggerSource` union, required
        - 'sync_transition'
        - 'scheduled_due_scan'
      - `senderPhoneNumber` string
      - `senderLabel` string
      - `conversationId` string
      - `conversationLink` string
    - `attemptsCount` number, required
    - `provider` union, required
      - 'cloudbeds'
      - 'siteminder'
      - 'mirai'
      - 'guesty'
      - 'hotelrunner'
      - 'wix'
      - 'simplebooking'
      - 'p3'
      - 'glofox'
      - 'shopify'
      - 'google_sheets'
    - `integrationId` string, required
    - `integrationName` string
    - `propertyId` string
    - `propertyName` string
    - `providerReservationId` string, required
    - `status` string, required
    - `checkInDate` string
    - `checkOutDate` string
    - `sourceUpdatedAt` string
    - `sourceFreshnessAt` string
    - `bookedAt` string
    - `guestFullName` string
    - `guestEmail` string
    - `guestPhone` string
    - `lastSyncedAt` string, required
    - `updatedAt` string, required
  - `filters` object, required
    - `integrations` object[], required
      - `provider` union, required
        - 'cloudbeds'
        - 'siteminder'
        - 'mirai'
        - 'guesty'
        - 'hotelrunner'
        - 'wix'
        - 'simplebooking'
        - 'p3'
        - 'glofox'
        - 'shopify'
        - 'google_sheets'
      - `integrationId` string, required
      - `integrationName` string
  - `availableStatuses` string[], required
  - `availableSorts` object[], required
    - `sortBy` union, required
      - 'check_in_date'
      - 'booked_at'
    - `sortDir` union, required
      - 'asc'
      - 'desc'
    - `label` string, required
  - `pageSize` number, required
  - `hasNext` boolean, required
  - `nextCursor` string

## Other responses

- `default`: Structured error

---

[API](https://skmtc.dev/visitoai/apis/visito-m2m-api.md) - [All operations](https://skmtc.dev/visitoai/apis/visito-m2m-api/llms.txt) - [OpenAPI document](https://skmtc.dev/visitoai/apis/visito-m2m-api/revisions/98377d35c234?raw)