List LLM calls

fromDate and toDate are required. fromDate is included in the results and toDate is not, so a full day is fromDate=2026-08-04T00:00:00Z&toDate=2026-08-05T00:00:00Z.

All other filters are optional and match exactly. Filters combine with AND, so adding more narrows the results.

source and sourceSubtype also accept older spellings and translate them for you — see those parameters for the details.

GET /api/public/analytics/projects/{projectId}/llm-ledger

List LLM calls

cURL

curl --request GET \
  --url https://{host}/api/public/analytics/projects/{projectId}/llm-ledger \
  --header 'x-api-key: <api-key>'

200

summary

{
  "success": true,
  "statusCode": 200,
  "total": 1,
  "limit": 100,
  "offset": 0,
  "dataMode": "summary",
  "hasMore": false,
  "generations": [
    {
      "id": "sess-1:call-1:2026-08-04T09:59:36.316Z:GPT-5.2:azure:1396:780:11659:0",
      "model": "GPT-5.2",
      "agentName": "Support Agent",
      "provider": "azure",
      "environment": "production",
      "status": "success",
      "inputTokens": 1396,
      "cachedTokens": 224,
      "completionTokens": 500,
      "reasoningTokens": 280,
      "outputTokens": 780,
      "totalTokens": 2176,
      "latencyMs": 11659,
      "timeToFirstTokenMs": 0,
      "streamingUsed": false,
      "cost": 0.42,
      "timestamp": "2026-08-04T09:59:36.316Z",
      "sessionId": "sess-1",
      "callId": "call-1",
      "traceId": "trace-1",
      "eventId": "event-1",
      "source": "runtime",
      "sourceSubtype": "response_generation",
      "sourceLabel": "Runtime",
      "sourceSubtypeLabel": "Response Generation",
      "sourceId": "agent-1",
      "channel": "web_chat",
      "channelType": "web_chat",
      "statusCode": 200,
      "payloadState": "available"
    }
  ]
}

Authorizations

x-api-key · string · header · required

Project-bound API key. Do not send an Authorization header.

Path Parameters

projectId · string · required

Minimum string length: 1

Query Parameters

fromDate · string<date-time> · required

toDate · string<date-time> · required

limit · integer · default: 100

How many calls to return. When dataMode=full, a page may come back with fewer rows than requested so the response stays within the 1 MiB size limit — check hasMore rather than assuming a short page is the last one.

Required range: 1 <= x <= 10000

offset · integer · default: 0

Required range: x >= 0

sessionIds · string[]

Filter to specific sessions. Pass up to 10,000 session IDs, comma-separated or by repeating the parameter.

Maximum array length: 10000

Minimum string length: 1

channel · enum<string>

Filter by the channel the conversation took place on. Design-time calls, such as Studio test calls, are not tied to a channel and will not match any channel filter.

Matched exactly as stored, with no alias handling. Unlike the sessions endpoint, shorthand such as web or sms is not expanded here — use the exact channel name such as web_chat or twilio_sms.

Not restricted to a fixed list, so an unrecognised value returns no results rather than an error. Cannot be empty (400 INVALID_FILTER).

Available options: http_async, slack, line, msteams, whatsapp, messenger, instagram, twilio_sms, zendesk, telegram, genesys, genesys_open_messaging, ai4w, kore_agent_assist, email, voice_vxml, korevg, audiocodes, genesys_audio_connector, voice_pipeline, voice_realtime, voice, voice_twilio, voice_livekit, ag_ui, a2a, sdk_websocket, web_debug, web_chat, api, http

source · enum<string>

Filter by which part of the platform made the call — for example runtime for live agent traffic, or evals for evaluation runs.

You can pass either the current name or an older one; the older spellings listed under x-alias-groups are translated for you, and matching is case-insensitive with - and spaces treated as _. So agent_session finds the same calls as runtime.

Not restricted to a fixed list, so an unrecognised value returns no results rather than an error. Cannot be empty (400 INVALID_FILTER).

Available options: runtime, runtime_internal, arch, evals, pipelines, guardrails, knowledge, studio_test_calls, channels, agent_session, eval, analytics_pipeline, analytics_query, guardrail, search_ai, prompt_library, model_health, model_admin, health:credential-store, sdk_widget_localization

sourceSubtype · enum<string>

Filter by the specific purpose of the call within its source — for example response_generation for replies to users, or guardrails for safety checks.

Older spellings are translated for you, as listed under x-alias-groups. If you also pass source, translation is limited to that source's subtypes; on its own, subtype names are resolved across all sources.

Not restricted to a fixed list, so an unrecognised value returns no results rather than an error. Cannot be empty (400 INVALID_FILTER).

Available options: response_generation, conversation_history_compaction, ner_gather_llm_extraction, model_based_pii_entity_recognizer, model_entity_preview, llm_backed_validation, searchai_kb_query_intelligence, searchai_query_assistance, routing_pipeline, pipeline_classifier, pipeline_tool_filter, pipeline_merge, contextual_filler_generation, tool_result_summarization, sip_handoff_summary, semantic_execution, legacy_nlu_fallback, general_assistance, project_assistance, eval_remediation, evaluation_suite_generation, natural_language_analytics_query, text_to_sql, guardrails, studio_test_calls, widget_copy_translation, tool_use_iteration, response_gen, realtime_response, conversation_compaction, nlu_entity_extraction, kb_classify_rewrite, field_validation, agent_building, eval_suite_creation, eval_design_time_asset_generation, nl_to_sql, nl_query, query_intelligence, prompt_test, prompt_experiment, credential_health_check, translation_generation

status · enum<string>

Filter to successful or failed calls. Any other value is rejected with 400 INVALID_STATUS.

Available options: success, failed

model · string

Filter by model, using the exact model id as recorded, such as gpt-4o. There is no fixed list, because each tenant can register its own models. Calls recorded without a model id appear as unknown and can be found with model=unknown. Cannot be empty (400 INVALID_FILTER).

Minimum string length: 1

provider · string

Filter by model provider, such as openai or azure. Calls recorded without a provider appear as unknown and can be found with provider=unknown.

Not restricted to a fixed list, so an unrecognised value returns no results rather than an error. The values below are the providers the platform can call. Cannot be empty (400 INVALID_FILTER).

Minimum string length: 1

environment · enum<string>

Filter by environment. Note that this endpoint stores development rather than dev — unlike the sessions endpoint, which uses dev. Design-time calls, such as Studio test calls, are not tied to an environment and will not match this filter.

Matched exactly as stored. Not restricted to a fixed list, so an unrecognised value returns no results rather than an error. Cannot be empty (400 INVALID_FILTER).

Available options: development, staging, production, working-copy

name · string

Exact effective agent name, operation type, or provider fallback.

Minimum string length: 1

channelType · enum<string>

Exact transport-specific channel type.

Available options: http_async, slack, line, msteams, whatsapp, messenger, instagram, twilio_sms, zendesk, telegram, genesys, genesys_open_messaging, ai4w, kore_agent_assist, email, voice_vxml, korevg, audiocodes, genesys_audio_connector, voice_pipeline, voice_realtime, voice, voice_twilio, voice_livekit, ag_ui, a2a, sdk_websocket, web_debug, web_chat, api, http

dataMode · enum<string> · default: summary

How much detail to return per call. summary returns the facts about each call. full also includes the prompt sent and the response received, under payload, where these were stored.

Available options: summary, full

sortBy · enum<string> · default: timestamp

Available options: timestamp, latencyMs, cost, totalTokens

sortOrder · enum<string> · default: asc

Available options: asc, desc

Response

200

application/json

LLM ledger page returned successfully.

success · boolean · required

Always true on a successful response.

statusCode · integer · required

HTTP status code returned by the provider — 200 when the call succeeded.

total · integer · required

Total number of calls matching your filters, across all pages.

Required range: x >= 0

limit · integer · required

The page size applied to this response.

Required range: 1 <= x <= 10000

offset · integer · required

The offset applied to this response.

Required range: x >= 0

dataMode · enum<string> · required

The detail level applied to this response, echoing your request.

Available options: summary, full

hasMore · boolean · required

Whether more pages are available after this one.

generations · object[] · required

The LLM calls on this page.

Show child attributes