Get Stats | Kokos API

Get statistics about the number of redemptions for each pack on a given date. 0 in the activations field means that the activation was successful, but was performed with codeOverride and requireReceipt set to false, and so the amount is unknown. 0 in the errors field means that the activation was unsuccessful, and the amount is unknown.

Authentication

AuthorizationBearer

Bearer authentication of the form `Bearer <token>`, where token is your auth token.

Query parameters

datedateOptional

The date to get statistics for. Defaults to the current date.

Response

This endpoint returns an object.

datedate

The date for which the statistics were requested

activationsmap from strings to integers

The number of activations for each pack

errorsmap from strings to integers

The number of errors for each pack

1	from kokos_activator_api import KokosApi
2	from kokos_activator_api.environment import KokosApiEnvironment
3	from datetime import date
4
5	client = KokosApi(
6	environment=KokosApiEnvironment.PRODUCTION,
7	token="YOUR_TOKEN_HERE"
8	)
9
10	client.history.get_stats(
11	date=date.fromisoformat("2025-05-12")
12	)

1	{
2	"date": "2025-05-12",
3	"activations": {
4	"0": 0,
5	"60": 18,
6	"325": 0,
7	"660": 5,
8	"1800": 2,
9	"3850": 0,
10	"8100": 0
11	},
12	"errors": {
13	"0": 5,
14	"60": 18,
15	"325": 0,
16	"660": 0,
17	"1800": 2,
18	"3850": 0,
19	"8100": 1
20	}
21	}