Usage-By-Product-Over-Time | ElevenLabs Documentation

Returns credit usage broken down by product type over time. Timestamps are Unix milliseconds. The response is a tabular structure with columns, column_types, column_units, and rows.

Request

This endpoint expects an object.

start_timeintegerRequired>=0

end_timeintegerRequired>=0

interval_secondsintegerOptional>=1Defaults to 60

group_bylist of enums or nullOptional

filterslist of objects or nullOptional

Response

Successful Response

columnslist of strings

column_typeslist of enums

rowslist of lists of nullable strings or integers or doubles or booleans

column_unitslist of nullable enums

Errors

422

Unprocessable Entity Error

1	curl -X POST https://api.elevenlabs.io/v1/workspace/analytics/query/usage-by-product-over-time \
2	-H "Content-Type: application/json" \
3	-d '{
4	"start_time": 1680307200000,
5	"end_time": 1680393600000
6	}'

1	{
2	"columns": [
3	"timestamp",
4	"product_type",
5	"credits_used"
6	],
7	"column_types": [
8	"DateTime",
9	"String",
10	"Float"
11	],
12	"rows": [
13	[
14	"2024-04-01T00:00:00Z",
15	"text-to-speech",
16	"125.5"
17	],
18	[
19	"2024-04-01T01:00:00Z",
20	"voice-cloning",
21	"75.0"
22	],
23	[
24	"2024-04-01T02:00:00Z",
25	"text-to-speech",
26	"130.2"
27	]
28	],
29	"column_units": [
30	"ms",
31	"",
32	"credits"
33	]
34	}

Headers

Request

Response

Errors