Get Team Token Data

GET

/api/v2/analytics/teams/token-counts

Analyticsv2

API endpoint for retrieving token usage statistics for specified teams.

Version:

2.1.0

Changelog:

v2.1.0: Added time series data support with bucket_type parameter

v2.0.0: New API version for team token usage data.

GET Parameters:

team_id (str): List of team IDs to filter by (can be specified multiple times as team_id=1&team_id=2)
verbose (bool): Whether to include detailed statistics (default: false)
type (str): Query type ('fixed' or 'range')
days (int): Number of days to look back (for 'fixed' type)
start_date (str): Start date in ISO format (for 'range' type)
end_date (str): End date in ISO format (for 'range' type)
time_series (bool): Whether to return data in time series format
bucket_type (str): Type of time bucket ('day', 'week', 'month')
limit (int): Number of top entities to return per date bucket (default: 10)

Returns:

JSON response containing token usage data for the specified teams

Request Example

Shell

JavaScript

Java

Swift

curl --location --request GET '/api/v2/analytics/teams/token-counts'

Response Example

200 - Standard Response

{
    "success": true,
    "message": "Team token counts data retrieved successfully",
    "data": {
        "token_counts": [
            {
                "team_name": "Example Team",
                "prompt_tokens": 1000,
                "completion_tokens": 500,
                "total_tokens": 1500
            }
        ]
    }
}

Request

Query Params

bucket_type

enum<string>

optional

Type of time bucket for time series data. Determines how data is grouped when time_series=true.

Allowed values:

daymonthweek

Default:

day

Example:

day

days

integer

optional

Number of days to look back from current date (only used when type=fixed)

Example:

end_date

string

optional

End date in ISO format (only used when type=range). Can be date only or include time.

Example:

2024-03-31

limit

integer

optional

Number of top entities to return per date bucket

Default:

Example:

start_date

string

optional

Start date in ISO format (only used when type=range). Can be date only or include time.

Example:

2024-03-01

team_id

array[integer]

optional

List of team IDs (can be specified multiple times as team_id=1&team_id=2)

time_series

boolean

optional

Whether to return data in time series format. When true, data will be grouped by the specified bucket_type.

Default:

false

Example:

true

type

enum<string>

optional

Query type for date range filtering. Use 'fixed' for relative time periods or 'range' for specific date ranges.

Allowed values:

fixedrange

Example:

fixed

verbose

boolean

optional

Whether to include detailed statistics

Default:

false

Responses

🟢200OK

application/json

Body

success

boolean

optional

Default:

true

message

string

required

data

object

optional

Default:

{"token_counts":[]}

Additional properties

array[object (TeamTokenUsage) {4}]

optional

🟠403Forbidden

🟠405405

🔴500Server Error

Get Team Summary Statistics

Get Team Vote Data