offers_usages_history (timeseries)

Required permit	Rate limit tokens cost	Available intervals
Reporting:Api:Report:OffersUsagesHistory	3	5m, 1h, 1d, 1w, 1mo

This report allows you to get events related with usages of offers.

Fields

loyalty_club_id

Type	Filterable
Integer	(via `X-Customer` header)

ID of loyalty club.

offer_type

Type	Filterable
Enum

Type of offer.

This field is an enum, possible values are:

regular

birthday

exclusive

welcome

competition

reward

carbon_offset_item

parking

parking_exclusive

game_prize

informational

offer_id

Type	Filterable
Integer

Offer ID.

store_id

Type	Filterable
Integer

ID of store to which offer is assigned.

collection_id

Type	Filterable
Integer

ID of collection to which offer is assigned.

member_gender

Type	Filterable
String

Gender of member who used the offer. See members report.

member_age

Type	Filterable
String

Age of member who used the offer. See members report.

member_place_id

Type	Filterable
Integer

Place ID (location) of member. See members report.

member_city_place_id

Type	Filterable
Integer

City place ID (location) of member. See members report.

authorized

Type	Filterable
Boolean

Whether offer usage was authorized (e.g. using QR code).

authorization_type

Type	Filterable
String

Type of authorization (e.g. QR code).

Query without aggregations

Query returns series with offers usages events.

Labels

{
    "interval": "5m",
    "range_timezone": "Europe/Oslo",
    "time_buckets": [
        "2025-08-27T09:25:00.000+02:00",
        "2025-08-27T09:30:00.000+02:00",
        "2025-08-27T09:35:00.000+02:00",
        "2025-08-27T09:40:00.000+02:00",
        "2025-08-27T09:45:00.000+02:00",
        "2025-08-27T09:50:00.000+02:00",
        "2025-08-27T09:55:00.000+02:00",
        "2025-08-27T10:00:00.000+02:00",
        "2025-08-27T10:05:00.000+02:00",
        "2025-08-27T10:10:00.000+02:00",
        "2025-08-27T10:15:00.000+02:00",
        "2025-08-27T10:20:00.000+02:00",
        "2025-08-27T10:25:00.000+02:00",
        "2025-08-27T10:30:00.000+02:00",
        "2025-08-27T10:35:00.000+02:00",
        "2025-08-27T10:40:00.000+02:00",
        "2025-08-27T10:45:00.000+02:00",
        "2025-08-27T10:50:00.000+02:00",
        "2025-08-27T10:55:00.000+02:00",
        "2025-08-27T11:00:00.000+02:00",
        "2025-08-27T11:05:00.000+02:00",
        "2025-08-27T11:10:00.000+02:00",
        "2025-08-27T11:15:00.000+02:00",
        "2025-08-27T11:20:00.000+02:00",
        "2025-08-27T11:25:00.000+02:00",
        "2025-08-27T11:30:00.000+02:00",
        "2025-08-27T11:35:00.000+02:00",
        "2025-08-27T11:40:00.000+02:00",
        "2025-08-27T11:45:00.000+02:00",
        "2025-08-27T11:50:00.000+02:00",
        "2025-08-27T11:55:00.000+02:00",
        "2025-08-27T12:00:00.000+02:00",
        "2025-08-27T12:05:00.000+02:00",
        "2025-08-27T12:10:00.000+02:00",
        "2025-08-27T12:15:00.000+02:00",
        "2025-08-27T12:20:00.000+02:00",
        "2025-08-27T12:25:00.000+02:00",
        "2025-08-27T12:30:00.000+02:00",
        "2025-08-27T12:35:00.000+02:00",
        "2025-08-27T12:40:00.000+02:00",
        "2025-08-27T12:45:00.000+02:00",
        "2025-08-27T12:50:00.000+02:00",
        "2025-08-27T12:55:00.000+02:00",
        "2025-08-27T13:00:00.000+02:00",
        "2025-08-27T13:05:00.000+02:00",
        "2025-08-27T13:10:00.000+02:00",
        "2025-08-27T13:15:00.000+02:00",
        "2025-08-27T13:20:00.000+02:00",
        "2025-08-27T13:25:00.000+02:00",
        "2025-08-27T13:30:00.000+02:00",
        "2025-08-27T13:35:00.000+02:00",
        "2025-08-27T13:40:00.000+02:00",
        "2025-08-27T13:45:00.000+02:00",
        "2025-08-27T13:50:00.000+02:00",
        "2025-08-27T13:55:00.000+02:00",
        "2025-08-27T14:00:00.000+02:00",
        "2025-08-27T14:05:00.000+02:00",
        "2025-08-27T14:10:00.000+02:00",
        "2025-08-27T14:15:00.000+02:00",
        "2025-08-27T14:20:00.000+02:00",
        "2025-08-27T14:25:00.000+02:00",
        "2025-08-27T14:30:00.000+02:00",
        "2025-08-27T14:35:00.000+02:00",
        "2025-08-27T14:40:00.000+02:00",
        "2025-08-27T14:45:00.000+02:00",
        "2025-08-27T14:50:00.000+02:00",
        "2025-08-27T14:55:00.000+02:00",
        "2025-08-27T15:00:00.000+02:00",
        "2025-08-27T15:05:00.000+02:00",
        "2025-08-27T15:10:00.000+02:00",
        "2025-08-27T15:15:00.000+02:00",
        "2025-08-27T15:20:00.000+02:00"
    ],
    "series": [
        {
            "label": {},
            "values": [
                3,
                2,
                10,
                5,
                4,
                2,
                5,
                null,
                20,
                5,
                5,
                7,
                11,
                8,
                3,
                4,
                7,
                8,
                4,
                8,
                2,
                7,
                9,
                19,
                9,
                3,
                16,
                null,
                2,
                2,
                8,
                null,
                26,
                9,
                1,
                2,
                2,
                5,
                3,
                8,
                6,
                16,
                10,
                2,
                null,
                5,
                8,
                null,
                2,
                1,
                1,
                8,
                9,
                12,
                6,
                1,
                1,
                6,
                12,
                3,
                9,
                3,
                5,
                3,
                14,
                7,
                2,
                7,
                6,
                7,
                2,
                null
            ]
        },
    ],
    "data_points": 259,
    "result_type": "timeseries"
}

Aggregations

member_gender

Labels

Key	Type	Description
member_gender	String	See in `Fields`

member_age

Labels

Key	Type	Description
member_age	Enum	See in `Fields`

member_city_place_id

Labels

Key	Type	Description
member_city_place_id	Integer	See in `Fields`

member_place_id

Labels

Key	Type	Description
member_place_id	Integer	See in `Fields`

authorized

Labels

Key	Type	Description
authorized	Boolean	See in `Fields`

authorization_type

Labels

Key	Type	Description
authorization_type	String	See in `Fields`

offers_usages_history (timeseries)

Fields#

loyalty_club_id#

offer_type#

offer_id#

store_id#

collection_id#

member_gender#

member_age#

member_place_id#

member_city_place_id#

authorized#

authorization_type#

Query without aggregations#

Labels#

Aggregations#

member_gender#

Labels#

member_age#

Labels#

member_city_place_id#

Labels#

member_place_id#

Labels#

authorized#

Labels#

authorization_type#

Labels#

Fields

loyalty_club_id

offer_type

offer_id

store_id

collection_id

member_gender

member_age

member_place_id

member_city_place_id

authorized

authorization_type

Query without aggregations

Labels

Aggregations

member_gender

Labels

member_age

Labels

member_city_place_id

Labels

member_place_id

Labels

authorized

Labels

authorization_type

Labels