Promotion is a JSON Structure definition published by Doordash, describing 5 properties, of which 2 are required. It conforms to the https://json-structure.org/meta/core/v0/# meta-schema.
{
"$schema": "https://json-structure.org/meta/core/v0/#",
"$id": "https://raw.githubusercontent.com/api-evangelist/doordash/refs/heads/main/json-structure/doordash-promotion-structure.json",
"name": "Promotion",
"description": "Promotion structure from DoorDash API",
"type": "object",
"properties": {
"merchant_supplied_id": {
"type": "string",
"description": "The merchant-supplied item identifier for the promoted item.",
"example": "D-12345"
},
"promotional_price": {
"type": "int32",
"description": "The promotional price in cents.",
"example": 42
},
"start_date": {
"type": "datetime",
"description": "The start date of the promotion in UTC ISO-8601 format.",
"example": "2026-06-02T14:30:00Z"
},
"end_date": {
"type": "datetime",
"description": "The end date of the promotion in UTC ISO-8601 format.",
"example": "2026-06-02T14:30:00Z"
},
"description": {
"type": "string",
"description": "A description of the promotion.",
"example": "Leave at the front desk."
}
},
"required": [
"merchant_supplied_id",
"promotional_price"
]
}
Discovery needs no key. Ratings and market analysis are Pro.
Get an API key
Free tier, no form to fill in. Signing in shares your email address with us — we
store it to create your key and to recognise you if you sign in with another
provider. See our Privacy Policy and
Terms.