Import bookings
curl --request POST \
--url https://api.letsdothis.com/v0/bookings/import \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"bookings": [
{
"externalBookingId": "<string>",
"ticketId": "<string>",
"participants": [
{
"fields": [
{
"fieldId": "<string>",
"value": "<string>",
"values": [
{
"value": "<string>",
"id": "<string>"
}
]
}
],
"status": {
"type": "CONFIRMED"
}
}
],
"idempotencyKey": "<string>",
"externalOrderId": "<string>",
"bookingFormId": "<string>",
"bookedAt": "2026-05-08T11:30:00.000Z",
"bookerFields": [
{
"fieldId": "<string>",
"value": "<string>",
"values": [
{
"value": "<string>",
"id": "<string>"
}
]
}
],
"status": {
"type": "CONFIRMED"
}
}
]
}
'const options = {
method: 'POST',
headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
body: JSON.stringify({
bookings: [
{
externalBookingId: '<string>',
ticketId: '<string>',
participants: [
{
fields: [
{
fieldId: '<string>',
value: '<string>',
values: [{value: '<string>', id: '<string>'}]
}
],
status: {type: 'CONFIRMED'}
}
],
idempotencyKey: '<string>',
externalOrderId: '<string>',
bookingFormId: '<string>',
bookedAt: '2026-05-08T11:30:00.000Z',
bookerFields: [
{
fieldId: '<string>',
value: '<string>',
values: [{value: '<string>', id: '<string>'}]
}
],
status: {type: 'CONFIRMED'}
}
]
})
};
fetch('https://api.letsdothis.com/v0/bookings/import', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));import requests
url = "https://api.letsdothis.com/v0/bookings/import"
payload = { "bookings": [
{
"externalBookingId": "<string>",
"ticketId": "<string>",
"participants": [
{
"fields": [
{
"fieldId": "<string>",
"value": "<string>",
"values": [
{
"value": "<string>",
"id": "<string>"
}
]
}
],
"status": { "type": "CONFIRMED" }
}
],
"idempotencyKey": "<string>",
"externalOrderId": "<string>",
"bookingFormId": "<string>",
"bookedAt": "2026-05-08T11:30:00.000Z",
"bookerFields": [
{
"fieldId": "<string>",
"value": "<string>",
"values": [
{
"value": "<string>",
"id": "<string>"
}
]
}
],
"status": { "type": "CONFIRMED" }
}
] }
headers = {
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text){
"jobId": "65d4e5f60718293a4b5c6d7e",
"status": "queued"
}{
"statusCode": 400,
"error": "<string>",
"message": "<string>"
}{
"statusCode": 409,
"error": "<string>",
"message": "<string>"
}{
"statusCode": 413,
"error": "<string>",
"message": "<string>"
}{
"error": "validation_failed",
"message": "<string>",
"totalRows": 123,
"rowsWithErrors": 123,
"errorCount": 123,
"summary": [
{
"code": "<string>",
"count": 123,
"message": "<string>",
"examples": [
{
"rowIndex": 123,
"externalBookingId": "<string>",
"participantIndex": 123,
"value": "<string>"
}
],
"fieldId": "<string>"
}
],
"errors": [
{
"rowIndex": 123,
"errors": [
{
"code": "<string>",
"message": "<string>",
"fieldId": "<string>",
"participantIndex": 123
}
],
"externalBookingId": "<string>"
}
],
"truncated": true
}{
"statusCode": 429,
"error": "<string>",
"message": "<string>"
}Bookings
Import bookings
Imports a batch of bookings from another platform. Each row is checked against its ticket’s booking form, then the bookings are created in the background as a job you poll. See how imports work.
How to use it
- Read a booking form’s import contract to see which fields each row can fill.
externalBookingIdis your id for the booking, and each one is imported once. Sending it again reportsalreadyImportedwith the original booking. To import corrected data for the same id, set a new rowidempotencyKey, or delete the imported booking first.- Set
bookingFormIdto choose the form a row is checked against. It’s required when the ticket has more than one live form. - Rows with the same
externalOrderIdshare onebookingReference, so a purchase that produced several bookings stays one order, even across batches. Reusing an order id adds bookings to that order. Payment records stay one per booking. - To import past bookings, set
statusto create them as withdrawn, deferred, canceled or due to be transferred. No withdrawal or deferral emails are sent. Leave it out for a confirmed booking. - Completed transfers, refunds and refunds taken as credit can’t be imported, because they need records an import doesn’t create.
POST
/
v0
/
bookings
/
import
Import bookings
curl --request POST \
--url https://api.letsdothis.com/v0/bookings/import \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"bookings": [
{
"externalBookingId": "<string>",
"ticketId": "<string>",
"participants": [
{
"fields": [
{
"fieldId": "<string>",
"value": "<string>",
"values": [
{
"value": "<string>",
"id": "<string>"
}
]
}
],
"status": {
"type": "CONFIRMED"
}
}
],
"idempotencyKey": "<string>",
"externalOrderId": "<string>",
"bookingFormId": "<string>",
"bookedAt": "2026-05-08T11:30:00.000Z",
"bookerFields": [
{
"fieldId": "<string>",
"value": "<string>",
"values": [
{
"value": "<string>",
"id": "<string>"
}
]
}
],
"status": {
"type": "CONFIRMED"
}
}
]
}
'const options = {
method: 'POST',
headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
body: JSON.stringify({
bookings: [
{
externalBookingId: '<string>',
ticketId: '<string>',
participants: [
{
fields: [
{
fieldId: '<string>',
value: '<string>',
values: [{value: '<string>', id: '<string>'}]
}
],
status: {type: 'CONFIRMED'}
}
],
idempotencyKey: '<string>',
externalOrderId: '<string>',
bookingFormId: '<string>',
bookedAt: '2026-05-08T11:30:00.000Z',
bookerFields: [
{
fieldId: '<string>',
value: '<string>',
values: [{value: '<string>', id: '<string>'}]
}
],
status: {type: 'CONFIRMED'}
}
]
})
};
fetch('https://api.letsdothis.com/v0/bookings/import', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));import requests
url = "https://api.letsdothis.com/v0/bookings/import"
payload = { "bookings": [
{
"externalBookingId": "<string>",
"ticketId": "<string>",
"participants": [
{
"fields": [
{
"fieldId": "<string>",
"value": "<string>",
"values": [
{
"value": "<string>",
"id": "<string>"
}
]
}
],
"status": { "type": "CONFIRMED" }
}
],
"idempotencyKey": "<string>",
"externalOrderId": "<string>",
"bookingFormId": "<string>",
"bookedAt": "2026-05-08T11:30:00.000Z",
"bookerFields": [
{
"fieldId": "<string>",
"value": "<string>",
"values": [
{
"value": "<string>",
"id": "<string>"
}
]
}
],
"status": { "type": "CONFIRMED" }
}
] }
headers = {
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text){
"jobId": "65d4e5f60718293a4b5c6d7e",
"status": "queued"
}{
"statusCode": 400,
"error": "<string>",
"message": "<string>"
}{
"statusCode": 409,
"error": "<string>",
"message": "<string>"
}{
"statusCode": 413,
"error": "<string>",
"message": "<string>"
}{
"error": "validation_failed",
"message": "<string>",
"totalRows": 123,
"rowsWithErrors": 123,
"errorCount": 123,
"summary": [
{
"code": "<string>",
"count": 123,
"message": "<string>",
"examples": [
{
"rowIndex": 123,
"externalBookingId": "<string>",
"participantIndex": 123,
"value": "<string>"
}
],
"fieldId": "<string>"
}
],
"errors": [
{
"rowIndex": 123,
"errors": [
{
"code": "<string>",
"message": "<string>",
"fieldId": "<string>",
"participantIndex": 123
}
],
"externalBookingId": "<string>"
}
],
"truncated": true
}{
"statusCode": 429,
"error": "<string>",
"message": "<string>"
}This endpoint is restricted and not generally available: organizations that have not been enabled receive a
403. Contact your Let’s Do This representative if you’d like access.Authorizations
Body
application/json
Was this page helpful?

