KFC

Get one KFC restaurant's current public promotions

Returns one restaurant's current public promotions -- current deals and offers KFC's storefront marks as public, with each promotion's id, internal and display name, description, whether it applies automatically, and active redemption codes when KFC exposes them. The returned codes can be passed to kfc-promotion. A store with no active public promotions returns an empty list rather than an error.

get/kfc/promotions

Request

  • Base URL: https://api.crawlora.net/api/v1
  • URL: https://api.crawlora.net/api/v1/kfc/promotions
  • Auth: API key in header x-api-key

Query parameters

store_numberstring required

KFC's alphanumeric store number, from /kfc/stores or /kfc/nearby

Headers

x-api-keystring required

API key required

Response

OK

codeinteger

Code is the HTTP status code or a custom code used to indicate the result of the request @example 200

msgunknown

Example response

{
  "data": {
    "count": 15,
    "promotions": [
      {
        "automatic": true,
        "display_name": "50% off Chicken Sandwich",
        "name": "Digital-Q324 - 50% off Chicken Sandwich",
        "promotion_id": "6815f409-5b1e-44dc-9f99-26b1c1a2699a",
        "redemption_codes": [
          "WALMART5DOLLARSOFF"
        ]
      }
    ],
    "store_number": "I824001"
  }
}

Changes

No recorded changes to this operation across all 2 revisions of this API.