curl --request GET \
--url https://api.letsdothis.com/v0/bookings/{id} \
--header 'Authorization: Bearer <token>'const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://api.letsdothis.com/v0/bookings/{id}', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));import requests
url = "https://api.letsdothis.com/v0/bookings/{id}"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text){
"id": "6399c20015d60ae3ff28f24c",
"status": "CONFIRMED",
"booker": {
"firstName": "Jean-Luc",
"lastName": "Picard",
"email": "jean@earlgrey.com",
"companyName": "Starfleet",
"address": {
"line1": "1701 Enterprise Ave",
"line2": "",
"city": "San Francisco",
"county": "San Francisco",
"country": "US",
"postcode": "94101"
},
"miscFields": []
},
"ticketId": "6399c11c58f29f001ca95934",
"createdAt": "2026-05-08T11:30:00.000Z",
"updatedAt": "2026-05-08T11:30:00.000Z",
"amount": {
"value": 5000,
"currencyCode": "AUD"
},
"participantCount": 123,
"gdprRedacted": true,
"externalBookingId": "ORD-100234",
"externalOrderId": "ORDER-4471",
"source": "INTERNAL",
"eventId": "2365756",
"eventOccurrenceId": "6399c11c58f29f001ca95935",
"bookedAt": "2026-05-08T11:30:00.000Z",
"transactionId": "6399c20015d60ae3ff28f24e",
"tracking": {
"utmParams": {
"utmSource": "newsletter",
"utmMedium": "email",
"utmCampaign": "bank-holiday"
}
},
"bookingReference": "br_K9F3P7W2QX5T"
}{
"statusCode": 404,
"error": "<string>",
"message": "<string>"
}Get a booking by ID
Returns a single booking by ID if it belongs to the organizer associated with your Public API credentials.
curl --request GET \
--url https://api.letsdothis.com/v0/bookings/{id} \
--header 'Authorization: Bearer <token>'const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://api.letsdothis.com/v0/bookings/{id}', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));import requests
url = "https://api.letsdothis.com/v0/bookings/{id}"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text){
"id": "6399c20015d60ae3ff28f24c",
"status": "CONFIRMED",
"booker": {
"firstName": "Jean-Luc",
"lastName": "Picard",
"email": "jean@earlgrey.com",
"companyName": "Starfleet",
"address": {
"line1": "1701 Enterprise Ave",
"line2": "",
"city": "San Francisco",
"county": "San Francisco",
"country": "US",
"postcode": "94101"
},
"miscFields": []
},
"ticketId": "6399c11c58f29f001ca95934",
"createdAt": "2026-05-08T11:30:00.000Z",
"updatedAt": "2026-05-08T11:30:00.000Z",
"amount": {
"value": 5000,
"currencyCode": "AUD"
},
"participantCount": 123,
"gdprRedacted": true,
"externalBookingId": "ORD-100234",
"externalOrderId": "ORDER-4471",
"source": "INTERNAL",
"eventId": "2365756",
"eventOccurrenceId": "6399c11c58f29f001ca95935",
"bookedAt": "2026-05-08T11:30:00.000Z",
"transactionId": "6399c20015d60ae3ff28f24e",
"tracking": {
"utmParams": {
"utmSource": "newsletter",
"utmMedium": "email",
"utmCampaign": "bank-holiday"
}
},
"bookingReference": "br_K9F3P7W2QX5T"
}{
"statusCode": 404,
"error": "<string>",
"message": "<string>"
}Authorizations
Bearer authentication header of the form Bearer <token>, where <token> is your auth token.
Path Parameters
The ID of the resource to query by
Response
Default Response
A booking — the transaction record for a registration. A booking may contain one or more participants (entries); read them via GET /v0/bookings/{id}/participants.
The unique identifier of the booking.
"6399c20015d60ae3ff28f24c"
The booking status. This field will contain one of the following values:
- CONFIRMED — The user has the application or registration fully confirmed.
For an application, this means the user is allowed to register for the event.
For a registration, this means the user has paid and is fully registered for the event.
- CANCELLED — The booking has been cancelled.
For an application, this means the user is not allowed to register for the event.
For a registration, this indicates that the user's entry has been cancelled, and they should not be allowed to participate in the event.
- WITHDRAWN — The user has withdrawn their application or registration.
For an application, this means the user is not allowed to register for the event.
For a registration, this indicates that the user has withdrawn their registration and should not be allowed to participate in the event.
Opt in with ?features=withdrawn_status to receive this value on a participant's status. Without the feature, a withdrawn participant is reported as CANCELLED for backwards compatibility. This gate applies only to participant status — a booking's own status always reports WITHDRAWN.
- DEFERRED — The user has deferred their application or registration.
This is semantically equivalent to CANCELLED and WITHDRAWN, with the distinction that the user is allowed to register for the event in the future.
- PENDING — The application or registration is not yet confirmed.
For an application, this means that manual approval or a ballot draw is pending to conclude the application's final status.
For a registration, this indicates that the registration process is not yet finalized. The user has been refunded for their registration.
- REFUNDED — The user has been refunded for their registration.
- REFUNDING — The user is in the process of being refunded for their registration.
- TO_BE_TRANSFERRED — The user has requested a transfer of their registration, but the transfer has not yet been confirmed.
- TRANSFERRED_EVENTS — The user has transferred their registration to another event.
- TRANSFERRED_TO_CREDIT — The user has transferred their registration to credit on their account.
- FAILED — The application was rejected (either manually or through ballot failure), as opposed to being cancelled by either the participant or the organizer, or withdrawn by the participant.
CONFIRMED, CANCELLED, WITHDRAWN, DEFERRED, PENDING, REFUNDED, REFUNDING, TO_BE_TRANSFERRED, TRANSFERRED_EVENTS, TRANSFERRED_TO_CREDIT, FAILED The booker — the person who made the booking.
Show child attributes
Show child attributes
{
"firstName": "Jean-Luc",
"lastName": "Picard",
"email": "jean@earlgrey.com",
"companyName": "Starfleet",
"address": {
"line1": "1701 Enterprise Ave",
"line2": "",
"city": "San Francisco",
"county": "San Francisco",
"country": "US",
"postcode": "94101"
},
"miscFields": []
}
The ticket the booking was made against.
"6399c11c58f29f001ca95934"
Represents a date and time in ISO 8601 format as a string.
The string should follow the format YYYY-MM-DDTHH:mm:ss.sssZ, where:
YYYY: Four-digit yearMM: Two-digit month (01-12)DD: Two-digit day of the month (01-31)T: Delimiter indicating the start of the time componentHH: Two-digit hour in 24-hour format (00-23)mm: Two-digit minutes (00-59)ss.sss: Seconds with milliseconds (00.000-59.999)Z: UTC timezone designator
Example: To represent 11:30 AM on May 8th, 2026, the value would be: "2026-05-08T11:30:00.000Z".
"2026-05-08T11:30:00.000Z"
Represents a date and time in ISO 8601 format as a string.
The string should follow the format YYYY-MM-DDTHH:mm:ss.sssZ, where:
YYYY: Four-digit yearMM: Two-digit month (01-12)DD: Two-digit day of the month (01-31)T: Delimiter indicating the start of the time componentHH: Two-digit hour in 24-hour format (00-23)mm: Two-digit minutes (00-59)ss.sss: Seconds with milliseconds (00.000-59.999)Z: UTC timezone designator
Example: To represent 11:30 AM on May 8th, 2026, the value would be: "2026-05-08T11:30:00.000Z".
"2026-05-08T11:30:00.000Z"
The total amount paid for the booking.
Show child attributes
Show child attributes
The number of participants (entries) in the booking.
The caller's own correlation id, present on bookings created through the import API.
"ORD-100234"
The caller's own order id, present on imported bookings that were part of an order. Every booking of that order carries the same one, so bookings sharing it were one purchase.
"ORDER-4471"
How this booking originated.
INTERNAL— booked through Let's Do This.EXTERNAL— imported from a third-party platform.API— imported by the organizer via the Public API.
INTERNAL, EXTERNAL, API The event the booking belongs to.
"2365756"
The event occurrence the booking belongs to.
"6399c11c58f29f001ca95935"
Represents a date and time in ISO 8601 format as a string.
The string should follow the format YYYY-MM-DDTHH:mm:ss.sssZ, where:
YYYY: Four-digit yearMM: Two-digit month (01-12)DD: Two-digit day of the month (01-31)T: Delimiter indicating the start of the time componentHH: Two-digit hour in 24-hour format (00-23)mm: Two-digit minutes (00-59)ss.sss: Seconds with milliseconds (00.000-59.999)Z: UTC timezone designator
Example: To represent 11:30 AM on May 8th, 2026, the value would be: "2026-05-08T11:30:00.000Z".
"2026-05-08T11:30:00.000Z"
The payment transaction id, if any.
"6399c20015d60ae3ff28f24e"
Digital marketing tracking parameters.
Show child attributes
Show child attributes
A stable, human-readable booking reference.
"br_K9F3P7W2QX5T"
Was this page helpful?