> ## Documentation Index > Fetch the complete documentation index at: https://docs.replo.app/llms.txt > Use this file to discover all available pages before exploring further. # List bookings > **Beta** — this endpoint may change before general availability. ## OpenAPI ````yaml /api-reference/openapi.json get /bookings openapi: 3.1.0 info: title: Replo Public API version: '2026-11-10' servers: - url: https://api.replo.app/v1 security: [] paths: /bookings: get: tags: - Bookings summary: List bookings description: '**Beta** — this endpoint may change before general availability.' operationId: bookings.list parameters: - name: Replo-Api-Version in: header required: true schema: type: string enum: - '2026-11-10' description: The public API version to use for this request. - schema: type: string format: uuid description: The project that owns the forms, from list_projects required: true description: The project that owns the forms, from list_projects name: projectId in: query - schema: type: string format: date-time description: Bookings that start at or after this time required: true description: Bookings that start at or after this time name: from in: query - schema: type: string format: date-time description: Bookings that start before this time; at most 92 days after from required: true description: Bookings that start before this time; at most 92 days after from name: to in: query - schema: type: integer minimum: 1 maximum: 100 description: How many to return, 1 to 100; 50 if left out required: false description: How many to return, 1 to 100; 50 if left out name: limit in: query - schema: type: string minLength: 1 maxLength: 200 description: The next_cursor of the previous page required: false description: The next_cursor of the previous page name: cursor in: query responses: '200': description: List bookings content: application/json: schema: type: object properties: object: type: string enum: - list data: type: array items: type: object properties: object: type: string enum: - booking id: type: string format: uuid projectId: type: string format: uuid serviceId: type: string format: uuid staffId: type: string format: uuid responseId: type: - string - 'null' format: uuid description: >- The form response the booking came with; null when added by hand status: type: string enum: - held - confirmed - cancelled - completed - no_show description: >- confirmed, cancelled, completed or no_show; held is a time a visitor is still filling in the form for startsAt: type: string endsAt: type: string seats: type: integer meetingUrl: type: - string - 'null' description: The Google Meet link, if any addOnKeys: type: array items: type: string contact: type: - object - 'null' properties: id: type: string format: uuid email: type: string name: type: - string - 'null' phone: type: - string - 'null' required: - id - email - name - phone description: The person the booking is for createdAt: type: string required: - object - id - projectId - serviceId - staffId - responseId - status - startsAt - endsAt - seats - meetingUrl - addOnKeys - contact - createdAt has_more: type: boolean next_cursor: type: - string - 'null' required: - object - data - has_more - next_cursor '400': description: Invalid request. content: application/json: schema: $ref: '#/components/schemas/PublicApiError' '401': description: >- Missing or invalid Replo Public API token. Send an active key as `Authorization: Bearer replo_sk_...`; if it was revoked, create a new key in Replo Settings. content: application/json: schema: $ref: '#/components/schemas/PublicApiError' '403': description: >- You are not authorized to access this resource. Ask a workspace owner to perform this action or to grant the key's creator access. content: application/json: schema: $ref: '#/components/schemas/PublicApiError' '404': description: >- Not Found. The resource may not exist, this key may lack the required scope, or the key's creator may have lost access. Check the key's scopes in Replo Settings and the creator's project or workspace access; a workspace owner can grant access. content: application/json: schema: $ref: '#/components/schemas/PublicApiError' '409': description: The resource is in a conflicting state. content: application/json: schema: $ref: '#/components/schemas/PublicApiError' '413': description: File content exceeds the 10 MiB limit. content: application/json: schema: $ref: '#/components/schemas/PublicApiError' '429': description: >- Too many requests. Please retry after the time indicated by the Retry-After header. content: application/json: schema: $ref: '#/components/schemas/PublicApiError' '500': description: An internal error occurred. content: application/json: schema: $ref: '#/components/schemas/PublicApiError' '503': description: Service temporarily unavailable. content: application/json: schema: $ref: '#/components/schemas/PublicApiError' security: - bearerAuth: [] components: schemas: PublicApiError: type: object properties: error: type: object properties: code: type: string message: type: string doc_url: type: string issues: type: array items: type: object properties: param: type: - string - 'null' description: >- Dotted path to the failing field within the request body, query or path, e.g. "name" or "variants.0.available"; null when the rule covers the whole input. message: type: string description: Why the field was rejected. required: - param - message description: >- Present on an invalid_request whose input failed validation: each failing field and why, at most 10. required: - code - message - doc_url required: - error securitySchemes: bearerAuth: type: http scheme: bearer ```` This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.