---
title: "Download manual coupons"
method: GET
path: "/v2/reward-suppliers/manual-coupons/{reward_supplier_id}/coupons"
tags: ["Reward Suppliers"]
---

# Download manual coupons

`GET /v2/reward-suppliers/manual-coupons/{reward_supplier_id}/coupons`

## Request

- Base URL: `https://api.extole.io`
- URL: `https://api.extole.io/v2/reward-suppliers/manual-coupons/{reward_supplier_id}/coupons`
- Auth: one of:
  - API key in header `Authorization`
  - API key in query parameter `access_token`
  - API key in cookie `extole_token`

Downloads the current coupon pool for the manual coupon supplier as a JSON response.

## Path parameters

- `reward_supplier_id` string, required

## Query parameters

- `operation_id` string, nullable
- `issued` boolean, nullable
- `include_expired` boolean, nullable
- `limit` string, nullable
- `offset` string, nullable

## Response `200`

Successful response

- ManualCouponRewardSupplierDownloadCouponsResponse
  - `coupons` string[], required
  - `uploaded_coupons` ManualCouponUploadResponse[], required
    - `coupon_code` string
    - `expires_at` string: [RFC 3339](https://datatracker.ietf.org/doc/html/rfc3339#section-5.6) or [RFC 9557](https://datatracker.ietf.org/doc/html/rfc9557#section-4) date-time with a numeric [UTC offset](https://datatracker.ietf.org/doc/html/rfc3339#section-5.6) and an optional [IANA time-zone](https://datatracker.ietf.org/doc/html/rfc9557#section-4) suffix in square brackets. Precision up to milliseconds.

## Other responses

- `400`: Bad Request
- `401`: Unauthorized
- `402`: Payment Required
- `403`: Forbidden
- `415`: Unsupported Media Type
- `429`: Too Many Requests

---

[API](https://skmtc.dev/extole/apis/integration-api-server-to-extole.md) - [All operations](https://skmtc.dev/extole/apis/integration-api-server-to-extole/llms.txt) - [OpenAPI document](https://skmtc.dev/extole/apis/integration-api-server-to-extole/revisions/c16e62e66755?raw)