---
title: "Get one KFC restaurant's current public promotions"
method: GET
path: "/kfc/promotions"
tags: ["KFC"]
---

# Get one KFC restaurant's current public promotions

`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`

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.

## Query parameters

- `store_number` string, required

## Headers

- `x-api-key` string, required

## Response `200`

OK

- KfcPromotionsResponseDoc
  - `code` integer: Code is the HTTP status code or a custom code used to indicate the result of the request @example 200
  - `data` KfcPromotionsResponse
    - `count` integer
    - `fetched_at` string
    - `promotions` KfcPromotion[]
      - `automatic` boolean
      - `description` string
      - `display_name` string
      - `name` string
      - `promotion_id` string
      - `redemption_codes` string[]: RedemptionCodes is populated from the public promotion's active code connection. It gives callers a durable discovery path for PromotionByCode instead of requiring a guessed or stale code.
    - `source_url` string
    - `store_number` string
  - `msg` unknown

## Other responses

- `400`: Bad Request
- `429`: Too Many Requests
- `503`: Service Unavailable

---

[API](https://skmtc.dev/crawlora/apis/crawlora-api.md) · [All operations](https://skmtc.dev/crawlora/apis/crawlora-api/llms.txt) · [OpenAPI document](https://skmtc.dev/crawlora/apis/crawlora-api/revisions/0497899e2016?raw)