---
title: "List Popeyes Rewards' bonus-points promotion catalog"
method: GET
path: "/popeyes/promotions"
tags: ["Popeyes"]
---

# List Popeyes Rewards' bonus-points promotion catalog

`GET /popeyes/promotions`

## Request

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

Returns a page of Popeyes Rewards' bonus-points promotion catalog -- flat or multiplied points bonuses tied to a qualifying purchase (e.g. "Get Double Bonus Points on Your Cart, minimum $20"), distinct from /popeyes/offers (priced menu deals) and /popeyes/quests (multi-step challenges). This is public CMS content, not a signed-in member's own applied-promotions state. points_multiplier and bonus_points are mutually exclusive in practice -- a promotion is either an "Nx points" campaign or a flat bonus. start_date/end_date bound the promotion's published active window when Popeyes sets one; both empty means no published window restriction, not that the promotion is permanently active.

## Query parameters

- `limit` integer
- `offset` integer
- `market` string

## Headers

- `x-api-key` string, required

## Response `200`

OK

- PopeyesPromotionsResponseDoc
  - `code` integer: Code is the HTTP status code or a custom code used to indicate the result of the request @example 200
  - `data` PopeyesPromotionsResponse
    - `count` integer
    - `fetched_at` string
    - `has_more` boolean: HasMore is a paging heuristic -- see OffersResponse.HasMore.
    - `promotions` PopeyesPromotion[]
      - `bonus_points` integer: BonusPoints is set for a flat bonus-points promotion.
      - `end_date` string
      - `id` string
      - `message` string: Message is the promotion's own display copy, when Popeyes publishes one distinct from Name.
      - `name` string: Name is the promotion's own internal/public label.
      - `points_multiplier` number: PointsMultiplier is set for a "Nx points" style promotion (e.g. 2 for double points); mutually exclusive in practice with BonusPoints.
      - `start_date` string: StartDate/EndDate bound the promotion's active window, when Popeyes publishes one -- both empty means no published window restriction.
    - `source_url` 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/afac9b012a27?raw)