# 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](https://docs.mpc.placewise.com/doc-344016#gender).
### member_age
| Type | Filterable |
| --- | --- |
| String | |
Age of member who used the offer. See [members report](https://docs.mpc.placewise.com/doc-344016#age).
### member_place_id
| Type | Filterable |
| --- | --- |
| Integer | |
Place ID (location) of member. See [members report](https://docs.mpc.placewise.com/doc-344016#place_id).
### member_city_place_id
| Type | Filterable |
| --- | --- |
| Integer | |
City place ID (location) of member. See [members report](https://docs.mpc.placewise.com/doc-344016#city_place_id).
### 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.
```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": {},
"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` |