---
title: "List Papa John's active promotions (international)"
method: GET
path: "/papajohns/intl/deals"
tags: ["Papa John's"]
---

# List Papa John's active promotions (international)

`GET /papajohns/intl/deals`

## Request

- Base URL: `https://api.crawlora.net/api/v1`
- URL: `https://api.crawlora.net/api/v1/papajohns/intl/deals`
- Auth: API key in header `x-api-key`

Returns the promotions currently running in one of six international markets: Chile, Costa Rica, Guatemala, Panama, Portugal, and Spain, for either delivery or pickup. Each promotion carries its headline product, description, artwork, the weekdays it runs on, and its start and end dates. Offers that upstream has marked inactive are omitted rather than returned as live.

## Query parameters

- `market` 'chile' | 'costa-rica' | 'guatemala' | 'panama' | 'portugal' | 'spain', required
- `dispatch_method` 'pj_delivery' | 'in_store', required

## Headers

- `x-api-key` string, required

## Response `200`

OK

- PapajohnsIntlDealsResponseDoc
  - `code` integer: Code is the HTTP status code or a custom code used to indicate the result of the request @example 200
  - `data` PapajohnsIntlDealsResponse
    - `count` integer
    - `deals` PapajohnsIntlDeal[]
      - `availability` string[]: Availability lists the weekdays the offer runs on.
      - `category` string
      - `description` string
      - `dispatch_method` string: DispatchMethod is the fulfillment this offer applies to.
      - `end_date` string
      - `id` integer
      - `image_url` string
      - `name` string
      - `offer_id` integer: OfferID is set when this promotion is backed by a structured offer, and is the id GET /papajohns/intl/offer takes to return its full composition. Absent when the banner points at something else.
      - `product` string: Product is the offer's headline product name.
      - `start_date` string
      - `url` string
    - `dispatch_method` string
    - `fetched_at` string
    - `market` string
    - `source_url` string
  - `msg` unknown

## Other responses

- `400`: Bad Request
- `404`: Not Found
- `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/028417aa35bb?raw)