List Offers

Returns offers list.

Query Parameters

Parameter	Type	Default	Description
scope	enum	`standard`	Determines the scope the API operates on. See Offers scoping
per_page	integer	100	Number of results to be returned per request (100 is the maximum)
page_no	integer	1	Number of results page
include_pagination_info	boolean	false	When true, pagination info (containing info like total records count, next page) will be returned
order_by	string	"name"	See `order_by` param
collection_ids	integer[]	null	When present, only offers belonging to least one of given collections will be returned
stores	string[]	null	When present, only offers having at least one of given stores will be returned
store_ids	integer[]	null	When present, only offers having at least one of given stores will be returned
ids	integer[]	null	When present, only offers with this id will be returned
type	string	null	When present, only offers of this type will be returned
campaign_id	integer[]	null	When present, only offers with this campaign_id will be returned
search	string	null	When present, only offers that match the query string will be returned
usable	boolean	false	When true, only offers that are usable will be returned
liked	boolean	false	When true, only offers that have been liked by member

All parameters are optional.

`order_by` param

Offers list may be sorted by order_by param, which has similar syntax as ORDER BY keyword in SQL statements.

For example order_by=usable ASC, created_at DESC will return offers sorted by their usability, then by their creation date.

Following offer attributes may be used for sorting in general:

name

usable_since

usable_until

created_at

Only in member context (does not work with /guest/ context:

usable

uses_left

liked

Also, when querying offers by single collection_id, the list may also be sorted by:

collection_position

Response Body

Key	Type	Optional?	Description
offers	Offer[]	no (may be empty)	See Offer model
pagination_info	PaginationInfo	yes	See Pagination info model

Example

When successful, returns a list of offers and pagination info. See Offer model and Offer model

{
  "offers": [
    {
      // (...) - see Offer model
    }
  ],
  "pagination_info": {
      // (...) - see Pagination info model
  }
}

Request Code Samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Ruby

Responses

🟢200Success

application/json

Body

Example

{
    "offers": [
        {
            "id": 1552282,
            "name": null,
            "type": "REGULAR",
            "description": null,
            "external_url": null,
            "usable_since": "2025-06-28T10:00:00.0Z",
            "usable_until": "2030-05-05T15:00:00.0Z",
            "usage_authorization_token_required": false,
            "collection_ids": [
                1029818
            ],
            "tags": [],
            "shops": [
                "Espresso House"
            ],
            "stores": [
                "Espresso House"
            ],
            "store_ids": [
                36
            ],
            "files": [
                null,
                {
                    "identifier": "1",
                    "created_at": "2022-11-09T15:46:00.252860Z",
                    "image_details": null
                },
                null
            ],
            "display": {},
            "liked": false,
            "usage": {},
            "extras": {
                "designa_rebate_time_seconds": 56
            },
            "authorization_code_displayed": true
        }
    ]
}

Query Parameters#

order_by param#

Response Body#

Example#

Request

Request Code Samples

Responses

Query Parameters

`order_by` param

Response Body

Example