Costs

Start time (Unix seconds) of the query time range, inclusive.

End time (Unix seconds) of the query time range, exclusive.

Width of each time bucket in response. Currently only 1d is supported, default to 1d.

Return only costs for these projects.

Return only costs for these API keys.

Return only costs for these exact line item names. Each value must match the complete line_item value, for example gpt-6-astra, input_tokens.

Group the costs by the specified fields. Supported fields include project_id, user_id, line_item, api_key_id, and api_source. Support for combining user_id with project_id grouping or the project_ids filter depends on the organization and requested time range. Unsupported combinations return HTTP 400. When grouped by api_source, results use agents_api for attributed Agents API activity and unlabeled for all other activity. Without source grouping, api_source is null.

A limit on the number of buckets to be returned. Limit can range between 1 and 180, and the default is 7.

A cursor for use in pagination. Corresponding to the next_page field from the previous response.