curl --request GET \
--url https://api.letsdothis.com/v0/discount-codes/{id} \
--header 'Authorization: Bearer <token>'const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://api.letsdothis.com/v0/discount-codes/{id}', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));import requests
url = "https://api.letsdothis.com/v0/discount-codes/{id}"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text){
"id": "661718293a4b5c6d7e8f901a",
"code": "FLEETFEET5",
"group": "fleet-feet-2026",
"description": "Fleet Feet post-race in-store incentive",
"flatRate": 500,
"maxValue": 500,
"startDate": "2026-09-01T00:00:00.000Z",
"expiresAt": "2026-12-31T23:59:59.000Z",
"limitUsage": 1,
"limitUsagePerUser": 1,
"eventIds": [],
"eventOccurrenceIds": [
"21111177799"
],
"appliesTo": [
"TICKETS"
],
"appliesPer": "TRANSACTION",
"createdAt": "2026-08-01T09:15:00.000Z"
}{
"statusCode": 403,
"error": "<string>",
"message": "<string>"
}{
"statusCode": 404,
"error": "<string>",
"message": "<string>"
}Get a discount code
Returns one of your discount codes by ID, described with the same fields an import accepts. The id is the discountCodeId an import reports for the code. Codes belonging to another organizer, and deleted codes, return 404.
curl --request GET \
--url https://api.letsdothis.com/v0/discount-codes/{id} \
--header 'Authorization: Bearer <token>'const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://api.letsdothis.com/v0/discount-codes/{id}', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));import requests
url = "https://api.letsdothis.com/v0/discount-codes/{id}"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text){
"id": "661718293a4b5c6d7e8f901a",
"code": "FLEETFEET5",
"group": "fleet-feet-2026",
"description": "Fleet Feet post-race in-store incentive",
"flatRate": 500,
"maxValue": 500,
"startDate": "2026-09-01T00:00:00.000Z",
"expiresAt": "2026-12-31T23:59:59.000Z",
"limitUsage": 1,
"limitUsagePerUser": 1,
"eventIds": [],
"eventOccurrenceIds": [
"21111177799"
],
"appliesTo": [
"TICKETS"
],
"appliesPer": "TRANSACTION",
"createdAt": "2026-08-01T09:15:00.000Z"
}{
"statusCode": 403,
"error": "<string>",
"message": "<string>"
}{
"statusCode": 404,
"error": "<string>",
"message": "<string>"
}403. Contact your Let’s Do This representative if you’d like access.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 discount code belonging to your organizer.
The unique ID of the discount code.
The code participants enter at checkout, uppercased.
The events the code is restricted to. Empty when it allows all of them.
The event occurrences the code is restricted to. Empty when it allows all of them.
How often a discount code comes off a basket. These are the same two options the organizer dashboard offers as its discount type.
TRANSACTION discounts the basket once, however many entries it holds. ENTRY discounts each participant's entry separately, so a basket of three entries is discounted three times.
TRANSACTION, ENTRY The internal code name: a free-form grouping label shown in the organizer dashboard and never seen by participants. Omitted when the code has none.
An internal description of the code, shown in the organizer dashboard.
The percentage discount the code applies. Omitted for flat-rate codes.
The fixed discount the code applies, in the minor unit of the event's currency (e.g. pence, cents).
The maximum total value the code can discount, in the minor unit of the event's currency.
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"
Whether the code only applies to a booker's first booking.
How many times the code can be used in total.
How many times a single user can use the code.
How many entries a single transaction can apply the code to.
Which parts of the basket the code discounts. Omitted when the code is restricted to none of the categories this API names — an unrestricted code comes off the whole basket.
The part of the basket a discount code applies to. These are the same categories the organizer dashboard offers, so a code created through the API and one created in the dashboard describe themselves the same way.
MERCH_AND_ADDONS covers every merchandise and add-on category; FORM_ITEMS covers the remaining booking form items.
TICKETS, BOOKING_FEE, MERCH_AND_ADDONS, FORM_ITEMS, MEMBERSHIPS 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"
Was this page helpful?