curl --location 'https://www.headout.com/api/public/v2/affiliate/bookings/?startTime=2026-01-01T00%3A00%3A00Z&endTime=2026-12-31T23%3A59%3A59Z&offset=0&limit=20' \
--header 'Headout-Auth: <YOUR_API_KEY>'
{
"items": [
{
"bookingId": "32435721",
"status": "PENDING",
"creationTimestamp": 1782812820,
"startDateTime": "2026-07-15T10:00:00Z",
"numberOfGuests": 2,
"product": {
"id": "5246",
"name": "Madame Tussauds London — Advance Purchase",
"city": "London",
"country": "United Kingdom",
"variants": [
{
"id": "18432",
"name": "General Admission"
}
]
},
"price": {
"currencyCode": "GBP",
"amount": 34.13,
"amountUSD": 45.20,
"couponCode": null,
"couponDiscount": null,
"couponDiscountUSD": null
},
"commission": {
"partnerEarningsUSD": 4.57
},
"attribution": {
"attributionType": "WEB",
"utmSource": "newsletter",
"utmMedium": "email",
"utmCampaign": "summer-london"
},
"user": {
"language": "en",
"country": "GB",
"device": "WEB"
}
},
{
"bookingId": "32435722",
"status": "PENDING",
"creationTimestamp": 1782813480,
"startDateTime": "2026-07-20T09:00:00Z",
"numberOfGuests": 1,
"product": {
"id": "1866",
"name": "Burj Khalifa — Entry Tickets",
"city": "Dubai",
"country": "United Arab Emirates",
"variants": [
{
"id": "7821",
"name": "At the Top (124th & 125th Floor)"
}
]
},
"price": {
"currencyCode": "AED",
"amount": 189.00,
"amountUSD": 51.47,
"couponCode": null,
"couponDiscount": null,
"couponDiscountUSD": null
},
"commission": {
"partnerEarningsUSD": 5.20
},
"attribution": {
"attributionType": "WEB",
"utmSource": "blog",
"utmMedium": "organic",
"utmCampaign": "dubai-guide"
},
"user": {
"language": "en",
"country": "IN",
"device": "WEB"
}
},
{
"bookingId": "32435723",
"status": "COMPLETED",
"creationTimestamp": 1782814140,
"startDateTime": "2026-07-04T14:00:00Z",
"numberOfGuests": 3,
"product": {
"id": "700",
"name": "AMNH — Dated Entry",
"city": "New York",
"country": "United States",
"variants": [
{
"id": "2201",
"name": "General Admission"
}
]
},
"price": {
"currencyCode": "USD",
"amount": 37.00,
"amountUSD": 37.00,
"couponCode": "SUMMER10",
"couponDiscount": 3.70,
"couponDiscountUSD": 3.70
},
"commission": {
"partnerEarningsUSD": 3.70
},
"attribution": {
"attributionType": "WEB",
"utmSource": "instagram",
"utmMedium": "social",
"utmCampaign": "nyc-summer"
},
"user": {
"language": "en",
"country": "US",
"device": "APP"
}
}
],
"nextUrl": "/api/public/v2/affiliate/bookings/?startTime=2026-01-01T00%3A00%3A00Z&endTime=2026-12-31T23%3A59%3A59Z&offset=3&limit=3",
"prevUrl": null,
"total": 7,
"nextOffset": 3
}
Bookings
List bookings
GET
/
api
/
public
/
v2
/
affiliate
/
bookings
/
curl --location 'https://www.headout.com/api/public/v2/affiliate/bookings/?startTime=2026-01-01T00%3A00%3A00Z&endTime=2026-12-31T23%3A59%3A59Z&offset=0&limit=20' \
--header 'Headout-Auth: <YOUR_API_KEY>'
{
"items": [
{
"bookingId": "32435721",
"status": "PENDING",
"creationTimestamp": 1782812820,
"startDateTime": "2026-07-15T10:00:00Z",
"numberOfGuests": 2,
"product": {
"id": "5246",
"name": "Madame Tussauds London — Advance Purchase",
"city": "London",
"country": "United Kingdom",
"variants": [
{
"id": "18432",
"name": "General Admission"
}
]
},
"price": {
"currencyCode": "GBP",
"amount": 34.13,
"amountUSD": 45.20,
"couponCode": null,
"couponDiscount": null,
"couponDiscountUSD": null
},
"commission": {
"partnerEarningsUSD": 4.57
},
"attribution": {
"attributionType": "WEB",
"utmSource": "newsletter",
"utmMedium": "email",
"utmCampaign": "summer-london"
},
"user": {
"language": "en",
"country": "GB",
"device": "WEB"
}
},
{
"bookingId": "32435722",
"status": "PENDING",
"creationTimestamp": 1782813480,
"startDateTime": "2026-07-20T09:00:00Z",
"numberOfGuests": 1,
"product": {
"id": "1866",
"name": "Burj Khalifa — Entry Tickets",
"city": "Dubai",
"country": "United Arab Emirates",
"variants": [
{
"id": "7821",
"name": "At the Top (124th & 125th Floor)"
}
]
},
"price": {
"currencyCode": "AED",
"amount": 189.00,
"amountUSD": 51.47,
"couponCode": null,
"couponDiscount": null,
"couponDiscountUSD": null
},
"commission": {
"partnerEarningsUSD": 5.20
},
"attribution": {
"attributionType": "WEB",
"utmSource": "blog",
"utmMedium": "organic",
"utmCampaign": "dubai-guide"
},
"user": {
"language": "en",
"country": "IN",
"device": "WEB"
}
},
{
"bookingId": "32435723",
"status": "COMPLETED",
"creationTimestamp": 1782814140,
"startDateTime": "2026-07-04T14:00:00Z",
"numberOfGuests": 3,
"product": {
"id": "700",
"name": "AMNH — Dated Entry",
"city": "New York",
"country": "United States",
"variants": [
{
"id": "2201",
"name": "General Admission"
}
]
},
"price": {
"currencyCode": "USD",
"amount": 37.00,
"amountUSD": 37.00,
"couponCode": "SUMMER10",
"couponDiscount": 3.70,
"couponDiscountUSD": 3.70
},
"commission": {
"partnerEarningsUSD": 3.70
},
"attribution": {
"attributionType": "WEB",
"utmSource": "instagram",
"utmMedium": "social",
"utmCampaign": "nyc-summer"
},
"user": {
"language": "en",
"country": "US",
"device": "APP"
}
}
],
"nextUrl": "/api/public/v2/affiliate/bookings/?startTime=2026-01-01T00%3A00%3A00Z&endTime=2026-12-31T23%3A59%3A59Z&offset=3&limit=3",
"prevUrl": null,
"total": 7,
"nextOffset": 3
}
Retrieve a paginated list of bookings attributed to your affiliate account within a given date range. Use this to reconcile earnings, audit attribution, and build your own reporting dashboard.
curl --location 'https://www.headout.com/api/public/v2/affiliate/bookings/?startTime=2026-01-01T00%3A00%3A00Z&endTime=2026-12-31T23%3A59%3A59Z&offset=0&limit=20' \
--header 'Headout-Auth: <YOUR_API_KEY>'
{
"items": [
{
"bookingId": "32435721",
"status": "PENDING",
"creationTimestamp": 1782812820,
"startDateTime": "2026-07-15T10:00:00Z",
"numberOfGuests": 2,
"product": {
"id": "5246",
"name": "Madame Tussauds London — Advance Purchase",
"city": "London",
"country": "United Kingdom",
"variants": [
{
"id": "18432",
"name": "General Admission"
}
]
},
"price": {
"currencyCode": "GBP",
"amount": 34.13,
"amountUSD": 45.20,
"couponCode": null,
"couponDiscount": null,
"couponDiscountUSD": null
},
"commission": {
"partnerEarningsUSD": 4.57
},
"attribution": {
"attributionType": "WEB",
"utmSource": "newsletter",
"utmMedium": "email",
"utmCampaign": "summer-london"
},
"user": {
"language": "en",
"country": "GB",
"device": "WEB"
}
},
{
"bookingId": "32435722",
"status": "PENDING",
"creationTimestamp": 1782813480,
"startDateTime": "2026-07-20T09:00:00Z",
"numberOfGuests": 1,
"product": {
"id": "1866",
"name": "Burj Khalifa — Entry Tickets",
"city": "Dubai",
"country": "United Arab Emirates",
"variants": [
{
"id": "7821",
"name": "At the Top (124th & 125th Floor)"
}
]
},
"price": {
"currencyCode": "AED",
"amount": 189.00,
"amountUSD": 51.47,
"couponCode": null,
"couponDiscount": null,
"couponDiscountUSD": null
},
"commission": {
"partnerEarningsUSD": 5.20
},
"attribution": {
"attributionType": "WEB",
"utmSource": "blog",
"utmMedium": "organic",
"utmCampaign": "dubai-guide"
},
"user": {
"language": "en",
"country": "IN",
"device": "WEB"
}
},
{
"bookingId": "32435723",
"status": "COMPLETED",
"creationTimestamp": 1782814140,
"startDateTime": "2026-07-04T14:00:00Z",
"numberOfGuests": 3,
"product": {
"id": "700",
"name": "AMNH — Dated Entry",
"city": "New York",
"country": "United States",
"variants": [
{
"id": "2201",
"name": "General Admission"
}
]
},
"price": {
"currencyCode": "USD",
"amount": 37.00,
"amountUSD": 37.00,
"couponCode": "SUMMER10",
"couponDiscount": 3.70,
"couponDiscountUSD": 3.70
},
"commission": {
"partnerEarningsUSD": 3.70
},
"attribution": {
"attributionType": "WEB",
"utmSource": "instagram",
"utmMedium": "social",
"utmCampaign": "nyc-summer"
},
"user": {
"language": "en",
"country": "US",
"device": "APP"
}
}
],
"nextUrl": "/api/public/v2/affiliate/bookings/?startTime=2026-01-01T00%3A00%3A00Z&endTime=2026-12-31T23%3A59%3A59Z&offset=3&limit=3",
"prevUrl": null,
"total": 7,
"nextOffset": 3
}
Authorizations
Query Parameters
Start of the date range (ISO 8601, e.g. 2026-01-01T00:00:00Z).
End of the date range (ISO 8601, e.g. 2026-12-31T23:59:59Z).
Number of bookings to skip for pagination.
Number of bookings to return per page. Maximum is 100.
Required range:
x <= 100Response
Successful response
Paginated list of affiliate bookings.
Show child attributes
Show child attributes
URL for the next page of results. Null if this is the last page.
URL for the previous page of results. Null if this is the first page.
Total number of bookings matching the query.
Offset to use for the next page. Null if this is the last page.
Was this page helpful?
⌘I