> ## Documentation Index > Fetch the complete documentation index at: https://docs.visitoai.com/llms.txt > Use this file to discover all available pages before exploring further. # List reservations > 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. ## OpenAPI ````yaml /openapi.json get /reservations openapi: 3.0.3 info: title: Visito M2M API version: 1.0.0 description: >- Tenant-scoped server-to-server API for channels, conversations, commerce, custom AI tools, and WhatsApp templates. Send operations are asynchronous and return queued acknowledgements. Expansion adds conversation controls, knowledge, sales opportunities, delivery status, reporting, and signed webhooks. servers: - url: https://platform-api.visitoai.com/m2m/v1 description: Production security: - bearerAuth: [] tags: - name: Channels - name: Conversations - name: Commerce - name: Custom tools - name: WhatsApp templates - name: Properties - name: Knowledge - name: Sales CRM - name: Delivery - name: Reporting - name: Webhooks paths: /reservations: get: summary: List reservations description: >- 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. operationId: list_reservations parameters: - name: integrationId in: query schema: type: string maxLength: 160 required: false - name: cursor in: query schema: type: string maxLength: 500 required: false - name: reservationId in: query schema: type: string maxLength: 160 required: false - name: status in: query schema: type: string maxLength: 64 required: false - name: sortBy in: query schema: type: string enum: - check_in_date - booked_at required: false - name: sortDir in: query schema: type: string enum: - asc - desc required: false responses: '200': description: Success content: application/json: schema: $ref: '#/components/schemas/ReservationMirrorDiagnosticsResponse' default: $ref: '#/components/responses/Error' components: schemas: ReservationMirrorDiagnosticsResponse: type: object properties: mirrors: type: array items: type: object properties: attempts: type: array items: type: object properties: createdAt: type: string lifecycleEventType: anyOf: - type: string enum: - booking_confirmed - type: string enum: - pre_checkin - type: string enum: - post_checkout_review result: anyOf: - type: string enum: - would_send - type: string enum: - deferred - type: string enum: - skipped - type: string enum: - invalid - type: string enum: - duplicate - type: string enum: - error reason: type: string attemptCount: type: number duplicateCount: type: number triggerSource: anyOf: - type: string enum: - sync_transition - type: string enum: - scheduled_due_scan senderPhoneNumber: type: string senderLabel: type: string conversationId: type: string conversationLink: type: string required: - createdAt - lifecycleEventType - result - reason - attemptCount - duplicateCount - triggerSource additionalProperties: false attemptsCount: type: number provider: anyOf: - type: string enum: - cloudbeds - type: string enum: - siteminder - type: string enum: - mirai - type: string enum: - guesty - type: string enum: - hotelrunner - type: string enum: - wix - type: string enum: - simplebooking - type: string enum: - p3 - type: string enum: - glofox - type: string enum: - shopify - type: string enum: - google_sheets integrationId: type: string integrationName: type: string propertyId: type: string propertyName: type: string providerReservationId: type: string status: type: string checkInDate: type: string checkOutDate: type: string sourceUpdatedAt: type: string sourceFreshnessAt: type: string bookedAt: type: string guestFullName: type: string guestEmail: type: string guestPhone: type: string lastSyncedAt: type: string updatedAt: type: string required: - attempts - attemptsCount - provider - integrationId - providerReservationId - status - lastSyncedAt - updatedAt additionalProperties: false filters: type: object properties: integrations: type: array items: type: object properties: provider: anyOf: - type: string enum: - cloudbeds - type: string enum: - siteminder - type: string enum: - mirai - type: string enum: - guesty - type: string enum: - hotelrunner - type: string enum: - wix - type: string enum: - simplebooking - type: string enum: - p3 - type: string enum: - glofox - type: string enum: - shopify - type: string enum: - google_sheets integrationId: type: string integrationName: type: string required: - provider - integrationId additionalProperties: false required: - integrations additionalProperties: false availableStatuses: type: array items: type: string availableSorts: type: array items: type: object properties: sortBy: anyOf: - type: string enum: - check_in_date - type: string enum: - booked_at sortDir: anyOf: - type: string enum: - asc - type: string enum: - desc label: type: string required: - sortBy - sortDir - label additionalProperties: false pageSize: type: number hasNext: type: boolean nextCursor: type: string required: - mirrors - filters - availableStatuses - availableSorts - pageSize - hasNext additionalProperties: false ErrorResponse: type: object required: - error properties: error: type: object required: - code - message properties: code: type: string example: M2M_AUTH_INSUFFICIENT_SCOPE message: type: string details: type: object additionalProperties: true example: error: code: M2M_AUTH_INSUFFICIENT_SCOPE message: M2M credential does not have required scope. details: requiredScopes: - conversations:write missingScopes: - conversations:write responses: Error: description: Structured error content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' securitySchemes: bearerAuth: type: http scheme: bearer bearerFormat: Visito M2M API key description: Server-side tenant-scoped credential created from Build > API Keys. ````