Skip to content

Fetch bookings for a customer

Request

Fetch bookings for the customer identified by {id}, within the given date range.

Security
BearerAuth
Path
idstringrequired

Customer id.

Example:cust_123456
Query
start_atstring, (date-time)required

Start of the range, an RFC 3339 date-time with an offset: Z for UTC or a numeric offset such as +08:00, in whole seconds. URL-encode the + as %2B.

Example:start_at=2026-01-20T00:00:00Z
end_atstring, (date-time)required

End of the range, in the same format as start_at.

Example:end_at=2026-01-27T00:00:00Z
cursorstring

Opaque pagination cursor. Pass the value from the previous response to fetch the next page.

Example:cursor=eyJvZmZzZXQiOjIwLCJsaW1pdCI6MjB9
limitinteger, [ 1 .. 100 ]
Default:100
Example:limit=100
curl -i -X GET \
  'https://developer.setmore.com/api/v2/bookings/customers/cust_123456?start_at=2026-01-20T00%3A00%3A00Z&end_at=2026-01-27T00%3A00%3A00Z&cursor=eyJvZmZzZXQiOjIwLCJsaW1pdCI6MjB9&limit=100' \
  -H 'Authorization: Bearer <YOUR_TOKEN_HERE>'

Responses

Bookings fetched.

Bodyapplication/json
dataArray of objects(Booking)
cursorstring

Opaque pagination cursor. Pass the value from the previous response to fetch the next page. Omitted entirely when there is no next page.

Example:"eyJvZmZzZXQiOjIwLCJsaW1pdCI6MjB9"
Response
{ "data": [ { … } ], "cursor": "eyJvZmZzZXQiOjIwLCJsaW1pdCI6MjB9" }