Endpoint Playground
Returns one promotion by its redemption code (the code a customer types in at checkout) or its serialized code (a unique per-print QR/serial code, e.g. from a printed coupon, that resolves to a shared redemption code and its promotion). Exactly one of code or serialized_code is required. A serialized-code lookup additionally returns that code's own usage metadata (redemption_code, times_used, code_status, group_status, effective_date, expiration_date) alongside the promotion. An unknown or expired code returns a 404 rather than a null success payload.
14 Oct 2026: Single record response; 5 fields had a value in every checked item.
Sample value profiles: name: “Digital - 2026_Q4_1101_Partnership_Buy Two $25 gift cards a…”; automatic: false; description: “$5 off”.
curl 'https://api.crawlora.net/api/v1/kfc/promotion' \
-H "x-api-key: $CRAWLORA_API_KEY"| Parameter | Type | Required | Prefilled value | Description |
|---|---|---|---|---|
| code | string | No | The redemption code as a customer would type it in at checkout. Use a value returned by kfc-promotions when available. Exactly one of code or serialized_code is required | |
| serialized_code | string | No | A unique per-print serialized/QR code that resolves to a shared redemption code. Exactly one of code or serialized_code is required |
{
"code": 200,
"msg": "OK",
"data": {
"promotion_id": "d8da51c0-3497-485a-b68d-a8aa464da799",
"name": "Digital - 2026_Q4_1101_Partnership_Buy Two $25 gift cards and get $5 off your next digital purchase",
"display_name": "$5 off",
"description": "$5 off",
"automatic": false,
"source_url": "https://www.kfc.com/api/kfc_us/storefront/graphql",
"fetched_at": "2026-09-21T03:37:59Z"
}
}The sample response, schema and code snippets below work without an account. Sending a live request needs an API key.