# offers_events_history (timeseries)

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

This report allows you to get events related with offers.

## Fields

### loyalty_club_id

| Type | Filterable |
| --- | --- |
| Integer | <Icon icon="material-outline-done"/> (via `X-Customer` header) |

ID of loyalty club.

### event_type

| Type | Filterable |
| --- | --- |
| Enum | <Icon icon="material-outline-done"/> |

Type of offer event.

This field is an enum, possible values are:

* used
* unique_used - produced when member uses the offer for the first time
* granted
* unique_granted - produced when offer is granted to member for the first time
* seen
* unique_seen - produced when offer member sees the offer for the first time
* clicked
* unique_clicked - produced when offer is clicked by the member for the first time
* liked
* unliked

### offer_type

| Type | Filterable |
| --- | --- |
| Enum | <Icon icon="material-outline-done"/> |

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 | <Icon icon="material-outline-done"/> |

Offer ID.


### store_id

| Type | Filterable |
| --- | --- |
| Integer | <Icon icon="material-outline-done"/> |

ID of store to which offer is assigned.

### collection_id

| Type | Filterable |
| --- | --- |
| Integer | <Icon icon="material-outline-done"/> |

ID of collection to which offer is assigned.

### application

| Type | Filterable |
| --- | --- |
| String | - |

Represents slug of API application (product/source) used when generating the event.

### platform

| Type | Filterable |
| --- | --- |
| Enum | - |

Represents platform used when generating the event. It is generating based on `application` field.

This field is an enum, possible values are:

* android
* ios
* website
* webforms
* other

## Query without aggregations

Query returns series with offers events labeled by `event_type`.

### Labels

| Key | Type | Description |
| --- | --- | --- |
| event_type | Enum | See in `Fields` |

```json
{
    "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": {
                "event_type": "used"
            },
            "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

### offer_type

#### Labels

| Key | Type | Description |
| --- | --- | --- |
| offer_type | Enum | See in `Fields` |
| event_type | Enum | See in `Fields` |

### store_id

#### Labels

| Key | Type | Description |
| --- | --- | --- |
| store_id | Integer | See in `Fields` |
| event_type | Enum | See in `Fields` |

### collection_id

#### Labels

| Key | Type | Description |
| --- | --- | --- |
| collection_id | Integer | See in `Fields` |
| event_type | Enum | See in `Fields` |

### platform

#### Labels

| Key | Type | Description |
| --- | --- | --- |
| platform | Enum | See in `Fields` |
| event_type | Enum | See in `Fields` |
