Metrics
List metric values. By default, the newest period of each metric series.
A categorical or boolean series folds its newest period into one row: distribution counts each value and value is the most frequent. Pages cover the first 10,000 values; narrow the filters or dates to read past them.
Permissions: authenticated (any role).
API key issued via POST /v1/{workspace_id}/api-keys. Pass the returned api_key value as a Bearer token.
Order of the page, e.g. -period_start (the default, newest first) or +metric_key.
[]productionPossible values: aggregatePossible values: Return each series' newest period only, a categorical or boolean period folded into one row.
true100Successful Response
Validation Error
Rate limited
GET /v1/{workspace_id}/metrics HTTP/1.1
Host: platform.api-us.concurrence.com
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*
{
"metrics": [
{
"metric_key": "text",
"source": "production",
"entity_type": "text",
"entity_id": "text",
"service_id": "text",
"run_id": "text",
"session_id": "text",
"period_start": "2026-01-01T00:00:00.000Z",
"period_end": "2026-01-01T00:00:00.000Z",
"event_count": 1,
"avg_confidence": 1,
"unit": "text",
"computed_at": "2026-01-01T00:00:00.000Z",
"metric_type": "text",
"value": 1
}
],
"has_more": true,
"continuation_token": null
}List the workspace's active metrics: builtins plus custom definitions.
Resolved from the workspace's metric settings, so a builtin turned off there is not listed.
Permissions: authenticated (any role).
API key issued via POST /v1/{workspace_id}/api-keys. Pass the returned api_key value as a Bearer token.
Successful Response
Rate limited
GET /v1/{workspace_id}/metrics/catalog HTTP/1.1
Host: platform.api-us.concurrence.com
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*
{
"metrics": [
{
"key": "text",
"name": "text",
"description": "text",
"metric_type": "numerical",
"source": "call_intelligence",
"custom_source_key": "text",
"extraction_mode": "static",
"granularity": "aggregate",
"period_granularity": "daily",
"latency_tier": "batch",
"model_tier": "free",
"unit": "text",
"has_prompt": false,
"builtin": true
}
]
}Get values for a specific metric with optional time range, newest period first.
Permissions: authenticated (any role).
API key issued via POST /v1/{workspace_id}/api-keys. Pass the returned api_key value as a Bearer token.
Metric key (lowercase alphanumeric + underscores)
^[a-z][a-z0-9_]*$productionPossible values: aggregatePossible values: 90Successful Response
Metric key is not defined in this workspace
Validation Error
Rate limited
GET /v1/{workspace_id}/metrics/{metric_key} HTTP/1.1
Host: platform.api-us.concurrence.com
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*
{
"metrics": [
{
"metric_key": "text",
"source": "production",
"entity_type": "text",
"entity_id": "text",
"service_id": "text",
"run_id": "text",
"session_id": "text",
"period_start": "2026-01-01T00:00:00.000Z",
"period_end": "2026-01-01T00:00:00.000Z",
"event_count": 1,
"avg_confidence": 1,
"unit": "text",
"computed_at": "2026-01-01T00:00:00.000Z",
"metric_type": "text",
"value": 1
}
]
}Get every value a metric recorded in the last days days, newest period first.
Permissions: authenticated (any role).
API key issued via POST /v1/{workspace_id}/api-keys. Pass the returned api_key value as a Bearer token.
Metric key (lowercase alphanumeric + underscores)
^[a-z][a-z0-9_]*$productionPossible values: aggregatePossible values: 30Successful Response
Metric key is not defined in this workspace
Validation Error
Rate limited
GET /v1/{workspace_id}/metrics/{metric_key}/trend HTTP/1.1
Host: platform.api-us.concurrence.com
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*
{
"metrics": [
{
"metric_key": "text",
"source": "production",
"entity_type": "text",
"entity_id": "text",
"service_id": "text",
"run_id": "text",
"session_id": "text",
"period_start": "2026-01-01T00:00:00.000Z",
"period_end": "2026-01-01T00:00:00.000Z",
"event_count": 1,
"avg_confidence": 1,
"unit": "text",
"computed_at": "2026-01-01T00:00:00.000Z",
"metric_type": "text",
"value": 1
}
]
}Last updated
Was this helpful?

