curl --request GET \
--url https://{host}/api/public/analytics/projects/{projectId}/llm-ledger \
--header 'x-api-key: <api-key>'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.
curl --request GET \
--url https://{host}/api/public/analytics/projects/{projectId}/llm-ledger \
--header 'x-api-key: <api-key>'dataMode parameter to control the level of detail returned. The default mode returns call-level facts, while full additionally includes the exact prompt and response payloads when available.
The available filtering criteria are:
- Date range — required:
fromDateandtoDate.fromDateis inclusive, whiletoDateis exclusive. - Source: Filter by the source of the LLM call.
- Source subtype: Further filter calls by source subtype.
- Model: Filter calls by the LLM model.
- Provider: Filter calls by the model provider.
- Other query parameters: The endpoint also supports pagination and sorting, but these control how results are returned rather than which records are included.
Authorizations
Project-bound API key. Do not send an Authorization header.
Path Parameters
1Query Parameters
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.
1 <= x <= 10000x >= 0Filter to specific sessions. Pass up to 10,000 session IDs, comma-separated or by repeating the parameter.
100001Filter 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 unrecognized value returns no results
rather than an error. Cannot be empty (400 INVALID_FILTER).
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 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).
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 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).
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 Filter to successful or failed calls. Any other value is rejected with 400 INVALID_STATUS.
success, failed 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).
1Filter 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).
1Filter by environment. 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).
development, staging, production, working-copy Exact effective agent name, operation type, or provider fallback.
1Exact transport-specific channel type.
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 Display name of the credential, auth profile or other source the call is attributed to. Matched case-insensitively against the name after trimming. When the name matches more than one source, all of them are included and the response carries attributionMatch.
1Exact attribution type recorded on the call, for example credential or auth_profile.
1Exact attribution ID recorded on the call. Combine with attributionType to select one credential or auth profile.
1Exact attribution scope recorded on the call.
1How 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.
summary, full timestamp, latencyMs, cost, totalTokens asc, desc Response
LLM ledger page returned successfully.
- Option 1
- Option 2
Always true on a successful response.
HTTP status code returned by the provider — 200 when the call succeeded.
Total number of calls matching your filters, across all pages.
x >= 0The page size applied to this response.
1 <= x <= 10000The offset applied to this response.
x >= 0The detail level applied to this response, echoing your request.
summary, full Whether more pages are available after this one.
The LLM calls on this page.
Show child attributes
Show child attributes
Present only when an attributionName filter matched more than one source.
Show child attributes
Show child attributes
Was this page helpful?