Billing
Return customer-visible LLM usage for an inclusive date range from one complete published calculation. Omit group_by for totals, daily usage, attribution, and service breakdowns; use group_by=model or group_by=class for those breakdowns. The optional service_id filter is applied before aggregation.
API key issued via POST /v1/{workspace_id}/api-keys. Pass the returned api_key value as a Bearer token.
First usage date to include.
Last usage date to include. It cannot be in the future.
Limit the report to usage attributed to this service.
Return model or usage-class breakdowns instead of the overview.
Successful Response
Missing or invalid authentication credentials.
Caller cannot access this workspace or lacks Data.view permission.
Workspace not found.
Workspace is archived.
Query validation failed: dates must be valid, end_date cannot be in the future, start_date must not follow end_date, and group_by must be supported.
Read rate limit exceeded.
The service or billing data is unavailable, or no complete calculation covers the period.
GET /v1/{workspace_id}/usage?start_date=2026-01-01&end_date=2026-01-01 HTTP/1.1
Host: platform.api-us.concurrence.com
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*
{
"workspace_id": "123e4567-e89b-12d3-a456-426614174000",
"period": {
"start_date": "2026-01-01",
"end_date": "2026-01-01"
},
"calculation_run_id": "123e4567-e89b-12d3-a456-426614174000",
"attribution": {
"conversation_attribution_rate": 1,
"service_attribution_rate": 1
},
"totals": {
"conversation_count": 1,
"request_count": 1,
"uncached_input_tokens": 1,
"cached_input_tokens": 1,
"output_tokens": 1,
"has_unpriced_usage": true,
"unpriced_tokens": 1
},
"daily": [
{
"usage_date": "2026-01-01",
"uncached_input_tokens": 1,
"cached_input_tokens": 1,
"output_tokens": 1
}
],
"services": [
{
"service_id": "123e4567-e89b-12d3-a456-426614174000",
"conversation_count": 1,
"request_count": 1,
"uncached_input_tokens": 1,
"cached_input_tokens": 1,
"output_tokens": 1
}
]
}Return Amigo-admin-only LLM cost for an inclusive date range from one complete published calculation. Omit group_by for workspace totals and service costs; use group_by=model to include each model's pricing status and applied rate records. The optional service_id filter is applied before aggregation.
API key issued via POST /v1/{workspace_id}/api-keys. Pass the returned api_key value as a Bearer token.
First usage date to include.
Last usage date to include. It cannot be in the future.
Limit the report to usage attributed to this service.
Return model costs and applied rates instead of the overview.
Successful Response
Missing or invalid authentication credentials.
Caller cannot access this workspace or is not an Amigo administrator.
Workspace not found.
Workspace is archived.
Query validation failed: dates must be valid, end_date cannot be in the future, start_date must not follow end_date, and group_by must be supported.
Read rate limit exceeded.
The service or billing data is unavailable, or no complete calculation covers the period.
GET /v1/{workspace_id}/cost?start_date=2026-01-01&end_date=2026-01-01 HTTP/1.1
Host: platform.api-us.concurrence.com
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*
{
"workspace_id": "123e4567-e89b-12d3-a456-426614174000",
"period": {
"start_date": "2026-01-01",
"end_date": "2026-01-01"
},
"calculation_run_id": "123e4567-e89b-12d3-a456-426614174000",
"totals": {
"calculated_cost_usd": "text",
"cost_per_conversation_usd": "text",
"has_unpriced_usage": true,
"unpriced_tokens": 1
},
"services": [
{
"service_id": "123e4567-e89b-12d3-a456-426614174000",
"calculated_cost_usd": "text",
"cost_share": 1
}
]
}Return customer-visible production-classified LLM usage and calculated model-provider cost for an inclusive UTC date range. The optional service_id filter is applied before aggregation. Unsupported v0 provenance and attribution fields remain null and successful responses report data_status=partial.
API key issued via POST /v1/{workspace_id}/api-keys. Pass the returned api_key value as a Bearer token.
First usage date to include.
Last usage date to include. It cannot be in the future.
Limit the report to usage attributed to this service.
Successful Response
Customer usage and calculated model-provider cost overview.
Service identifier; null for unattributed usage.
V0 returns partial for a published calculation, or failed when no complete calculation covers the period.
Source-event freshness; null because the published facts do not retain it.
Opaque published-calculation identifier; null when no complete calculation covers the period.
Reproducible rate-card identifier; null because the published facts do not retain it.
Invalid usage period.
Missing or invalid authentication credentials.
Caller cannot view this workspace's usage.
Workspace does not exist.
Workspace is archived.
Query validation failed because service_id is not a valid UUID.
Read rate limit exceeded.
Usage data is unavailable.
GET /v1/{workspace_id}/usage-cost/overview?start_date=2026-01-01&end_date=2026-01-01 HTTP/1.1
Host: platform.api-us.concurrence.com
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*
{
"workspace_id": "123e4567-e89b-12d3-a456-426614174000",
"period": {
"start_date": "2026-01-01",
"end_date": "2026-01-01",
"timezone": "text"
},
"service_id": "123e4567-e89b-12d3-a456-426614174000",
"attribution_status": "text",
"attribution": {
"conversation_attribution_rate": 1,
"service_attribution_rate": 1,
"may_include_amigo_operated_usage": true
},
"data_status": "complete",
"data_as_of": "2026-01-01T00:00:00.000Z",
"calculation_run_id": "text",
"rate_card_version": "text",
"currency": "text",
"totals": {
"conversation_count": 1,
"request_count": 1,
"uncached_input_tokens": 1,
"cached_input_tokens": 1,
"output_tokens": 1,
"calculated_cost_usd": "text",
"cost_per_conversation_usd": "text",
"has_unpriced_usage": true,
"unpriced_tokens": 1
},
"daily": [
{
"usage_date": "2026-01-01",
"uncached_input_tokens": 1
}
],
"services": [
{
"service_id": "123e4567-e89b-12d3-a456-426614174000",
"service_name": "text",
"conversation_count": 1,
"request_count": 1,
"uncached_input_tokens": 1,
"cached_input_tokens": 1,
"output_tokens": 1,
"calculated_cost_usd": "text",
"cost_per_conversation_usd": "text",
"cost_share": 1,
"has_unpriced_usage": true,
"unpriced_tokens": 1
}
],
"latest_close": {
"close_month": "2026-01-01",
"status": "text",
"calculated_at": "2026-01-01T00:00:00.000Z",
"calculation_run_id": "text",
"rate_card_version": "text",
"calculated_cost_usd": "text",
"uncached_input_tokens": 1,
"cached_input_tokens": 1,
"output_tokens": 1,
"has_unpriced_usage": true,
"unpriced_tokens": 1
}
}Return customer-visible production-classified LLM usage and calculated model-provider cost grouped by model. The optional service_id filter is applied before aggregation. Rates and money are decimal strings.
API key issued via POST /v1/{workspace_id}/api-keys. Pass the returned api_key value as a Bearer token.
First usage date to include.
Last usage date to include. It cannot be in the future.
Limit the report to usage attributed to this service.
Successful Response
Customer usage and calculated model-provider cost grouped by model.
Distinct linked conversations in the selected scope; conversations shared by models are counted once.
Invalid usage period.
Missing or invalid authentication credentials.
Caller cannot view this workspace's usage.
Workspace does not exist.
Workspace is archived.
Query validation failed because service_id is not a valid UUID.
Read rate limit exceeded.
Usage data is unavailable.
GET /v1/{workspace_id}/usage-cost/models?start_date=2026-01-01&end_date=2026-01-01 HTTP/1.1
Host: platform.api-us.concurrence.com
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*
{
"workspace_id": "123e4567-e89b-12d3-a456-426614174000",
"period": {
"start_date": "2026-01-01",
"end_date": "2026-01-01"
},
"service_id": "123e4567-e89b-12d3-a456-426614174000",
"conversation_count": 1,
"currency": "text",
"models": [
{
"model_id": "text",
"provider": "text",
"request_count": 1,
"calls_per_conversation": 1,
"uncached_input_tokens": 1,
"cached_input_tokens": 1,
"cache_rate": 1,
"output_tokens": 1,
"applied_rates": [
{
"rate_card_version": "text",
"effective_from": "2026-01-01T00:00:00.000Z",
"effective_to": "2026-01-01T00:00:00.000Z",
"input_per_million": "text",
"cached_input_per_million": "text",
"output_per_million": "text"
}
],
"calculated_cost_usd": "text",
"cost_share": 1,
"is_priced": true,
"unpriced_reason": "text"
}
]
}Return simulation, playground, customer-test, Amigo-internal, and unresolved usage excluded from the customer's production-classified totals. The optional service_id filter is applied before aggregation.
API key issued via POST /v1/{workspace_id}/api-keys. Pass the returned api_key value as a Bearer token.
First usage date to include.
Last usage date to include. It cannot be in the future.
Limit the report to usage attributed to this service.
Successful Response
Usage explicitly excluded from production-classified totals.
Invalid usage period.
Missing or invalid authentication credentials.
Caller cannot view this workspace's usage.
Workspace does not exist.
Workspace is archived.
Query validation failed because service_id is not a valid UUID.
Read rate limit exceeded.
Usage data is unavailable.
GET /v1/{workspace_id}/usage-cost/excluded?start_date=2026-01-01&end_date=2026-01-01 HTTP/1.1
Host: platform.api-us.concurrence.com
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*
{
"workspace_id": "123e4567-e89b-12d3-a456-426614174000",
"period": {
"start_date": "2026-01-01",
"end_date": "2026-01-01"
},
"classes": [
{
"usage_class": "simulation",
"exclusion_reason": "simulation",
"conversation_count": 1,
"request_count": 1,
"uncached_input_tokens": 1,
"cached_input_tokens": 1,
"output_tokens": 1
}
]
}Last updated
Was this helpful?