List Bookings

Returns a paginated list of bookings for the authenticated customer.

Endpoint

GET /bookings

Authentication

Requires a valid JWT access token.

Authorization: Bearer eyJhbGciOiJSUzI1NiJ9...

Query Parameters

Parameter	Type	Default	Description
`limit`	integer	50	Number of bookings to return (1 to 100)
`cursor`	string	-	Booking ID to paginate from
`status`	string	-	Filter by booking status
`range`	string	-	Use `upcoming` for future bookings or `past` for historical bookings
`upcoming`	boolean	false	Deprecated compatibility option; use `range=upcoming`

Status Values

Status	Description
`scheduled`	Booking has been scheduled but not yet confirmed
`confirmed`	Booking is confirmed
`reminder_sent`	A reminder has been sent
`waiting_room`	Customer is in a waiting room
`waiting_list`	Customer is on a waiting list
`checked_in`	Customer has checked in
`active`	Customer is present and the booking is active
`in_progress`	Service is in progress
`completed`	Booking took place as scheduled
`cancelled`	Booking was cancelled
`no_show`	Customer did not show up
`rescheduled`	Booking was moved to another time

Example Request

curl -X GET "https://edge.tiquo.app/api/client/v1/bookings?range=upcoming&limit=10" \
  -H "Authorization: Bearer eyJhbGciOiJSUzI1NiJ9..."

Response

{
  "success": true,
  "data": {
    "bookings": [
      {
        "id": "booking_123",
        "bookingNumber": "BK-001234",
        "status": "confirmed",
        "date": 1706662800000,
        "startTime": "14:30",
        "endTime": "15:30",
        "duration": 60,
        "timezone": "America/New_York",
        "attendeeCount": 2,
        "serviceName": "Consultation",
        "serviceCategoryName": "Appointments",
        "ticketing": {
          "qrCodeTicketsEnabled": true,
          "walletTicketsEnabled": true,
          "ticketDownloadUrl": "https://edge.tiquo.app/api/client/v1/booking-ticket?bookingId=booking_123",
          "walletTicketUrl": "https://cards.tiquo.app/ticket/org_123/BK-001234"
        },
        "serviceId": "svc_123",
        "sublocationId": "loc_456",
        "customerNotes": "Please use the side entrance.",
        "checkedInAt": 1706664000000,
        "createdAt": 1706576400000
      }
    ],
    "hasMore": false
  }
}

Booking Object

Field	Type	Description
`id`	string	Booking document ID
`bookingNumber`	string	Human-readable booking number (e.g. `BK-001234`)
`status`	string	Booking status (see values above)
`date`	integer	Unix timestamp in milliseconds for the booking date
`startTime`	string	Start time in `HH:mm` format
`endTime`	string	End time in `HH:mm` format
`duration`	integer	Duration in minutes
`timezone`	string	Timezone of the booking (e.g. `America/New_York`)
`attendeeCount`	integer	Number of attendees
`serviceName`	string	Name of the booked service. When available, this comes from the order item snapshot captured when the booking was made.
`serviceCategoryName`	string or omitted	Service category captured for the booking
`ticketing`	object	Ticket availability and download links for the booking
`serviceId`	string	ID of the booked service
`sublocationId`	string	ID of the sublocation
`customerNotes`	string or omitted	Notes saved on the booking for the customer
`createdAt`	integer	Unix timestamp in milliseconds when the booking was created
`checkedInAt`	integer or omitted	Unix timestamp in milliseconds when the customer checked in
`completedAt`	integer or omitted	Unix timestamp in milliseconds when the booking completed
`cancelledAt`	integer or omitted	Unix timestamp in milliseconds when the booking was cancelled

Ticketing Object

Field	Type	Description
`qrCodeTicketsEnabled`	boolean	Whether a QR-code ticket PDF can be downloaded
`walletTicketsEnabled`	boolean	Whether Apple Wallet and Google Wallet ticket links are available
`ticketDownloadUrl`	string or omitted	Direct ticket download URL, when QR-code tickets are enabled
`walletTicketUrl`	string or omitted	Wallet ticket URL, when wallet tickets are enabled
`appleWalletTicketUrl`	string or omitted	Apple Wallet ticket URL
`googleWalletTicketUrl`	string or omitted	Google Wallet ticket URL

For ticket downloads, see Download Booking Ticket.

Pagination

When hasMore is true, pass the response's nextCursor as the cursor parameter to get the next page.

Errors

Status	Description
`401`	Invalid or expired access token
`500`	Internal server error

Code Examples

JavaScript

async function getBookings(accessToken, options = {}) {
  const params = new URLSearchParams();
  if (options.limit) params.set('limit', options.limit);
  if (options.cursor) params.set('cursor', options.cursor);
  if (options.status) params.set('status', options.status);
  if (options.range) params.set('range', options.range);
  if (options.upcoming) params.set('upcoming', 'true');

  const response = await fetch(
    `https://edge.tiquo.app/api/client/v1/bookings?${params}`,
    {
      headers: { 'Authorization': `Bearer ${accessToken}` },
    }
  );

  return response.json();
}

// Fetch upcoming bookings
const result = await getBookings(token, { range: 'upcoming', limit: 10 });
console.log(`You have ${result.data.bookings.length} upcoming bookings`);

// Fetch past bookings
const past = await getBookings(token, { range: 'past', limit: 10 });

List Bookings

En esta página