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",
        "serviceImage": "https://images.example/consultation-room.jpg",
        "location": {
          "id": "loc_789",
          "name": "Midtown",
          "sublocationId": "loc_456",
          "sublocationName": "Treatment rooms",
          "address": "350 Fifth Avenue",
          "city": "New York",
          "state": "NY",
          "postalCode": "10118",
          "country": "US",
          "coordinates": { "lat": 40.7484, "lng": -73.9857 },
          "timezone": "America/New_York"
        },
        "customerActions": {
          "canCancel": true,
          "canReschedule": true,
          "isWaitlist": false,
          "cancellationDeadlineHours": 24
        },
        "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
`serviceImage`	string or omitted	Header image for the booking: the service's featured image, its first image, or its category image
`location`	object or omitted	The venue and sublocation the booking is at (see below)
`customerActions`	object	What the customer can do with the booking online. See Cancel and Reschedule Bookings
`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

Location object

Field	Type	Description
`id`	string	Location (venue) ID
`name`	string	Location name
`sublocationId`	string	Sublocation ID
`sublocationName`	string	Sublocation name
`address`, `city`, `state`, `postalCode`, `country`	string or omitted	The venue address. When the sublocation has its own address, that address is used
`coordinates`	object or omitted	`lat` and `lng`
`timezone`	string or omitted	The location's timezone

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. To let customers cancel or move a booking, see Cancel and Reschedule Bookings.

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

On this page