curl --request POST \
--url https://{host}/api/public/analytics/projects/{projectId}/llm-ledger \
--header 'Content-Type: application/json' \
--header 'x-api-key: <api-key>' \
--data '
{
"fromDate": "2026-08-01T00:00:00.000Z",
"toDate": "2026-08-02T00:00:00.000Z",
"status": "failed",
"dataMode": "summary",
"sortBy": "timestamp",
"sortOrder": "desc",
"limit": 50,
"offset": 0
}
'{
"protected": "eyJhbGciOiJSU0EtT0FFUC0yNTYiLCJlbmMiOiJBMjU2R0NNIiwia2lkIjoiNjZmN2ExYzJlNGIwYTFkMmMzZTRmNWE2IiwicGtmIjoiYTk1YWRiNGE2NTAwOTdmMzk1YTcyZDE0M2M4OGFjZmYxZDdmNzE3OTlkYzZmNDFiNjhiZDU5YmQzMGI1Mjc0MiJ9",
"encrypted_key": "CYZa0douXIvcxdFpLN93tTs84XAkpHSBv9cCmiIoL7NgSdIhH3zn31vC0pnzWSKzIlZzrAPOQSRj7DNYY1wUM7q66HqYLeB0Z4fQaJ-WRpTNoP4i7rO-EB4lSQTMo8hm0gPFIY1QuiMv5QBVqqYMpyE32keFnj_JjC3YIN9QwyvyDScEbJ6nCqG9etkkpS_yHBRDP7vgtzBWT0MEuE2Xotu4fLV7WHDtNrS5FjpTE6FdaRPHnqs4mFtrmJaGWZzBdp5ssIffrS8OzXPo-eAW9NIZzzY3LnrNm0LeC5Rke9SBRh-EhP7ggHv_GlhM13v8d-qfFjeD15CIRZTU5UmnIA",
"iv": "N2dEX08LzFPtTZiA",
"ciphertext": "nZsJoUJj3bjdddpTOa--ww",
"tag": "OUVK4WI9pnx0vPxB5dxZNg"
}{
"error": {
"code": "<string>",
"message": "<string>",
"details": {}
},
"success": false,
"message": "<string>",
"required": "<string>"
}{
"error": {
"code": "<string>",
"message": "<string>",
"details": {}
},
"success": false,
"message": "<string>",
"required": "<string>"
}{
"error": {
"code": "<string>",
"message": "<string>",
"details": {}
},
"success": false,
"message": "<string>",
"required": "<string>"
}{
"error": {
"code": "<string>",
"message": "<string>",
"details": {}
},
"success": false,
"message": "<string>",
"required": "<string>"
}{
"error": {
"code": "<string>",
"message": "<string>",
"details": {}
},
"success": false,
"message": "<string>",
"required": "<string>"
}{
"error": {
"code": "<string>",
"message": "<string>",
"details": {}
},
"success": false,
"message": "<string>",
"required": "<string>"
}{
"error": {
"code": "<string>",
"message": "<string>",
"details": {}
},
"success": false,
"message": "<string>",
"required": "<string>"
}{
"error": {
"code": "<string>",
"message": "<string>",
"details": {}
},
"success": false,
"message": "<string>",
"required": "<string>"
}{
"error": {
"code": "<string>",
"message": "<string>",
"details": {}
},
"success": false,
"message": "<string>",
"required": "<string>"
}List LLM calls using JWE payload
List LLM calls with the query parameters in a JSON or encrypted JWE request body instead of the URL.
curl --request POST \
--url https://{host}/api/public/analytics/projects/{projectId}/llm-ledger \
--header 'Content-Type: application/json' \
--header 'x-api-key: <api-key>' \
--data '
{
"fromDate": "2026-08-01T00:00:00.000Z",
"toDate": "2026-08-02T00:00:00.000Z",
"status": "failed",
"dataMode": "summary",
"sortBy": "timestamp",
"sortOrder": "desc",
"limit": 50,
"offset": 0
}
'{
"protected": "eyJhbGciOiJSU0EtT0FFUC0yNTYiLCJlbmMiOiJBMjU2R0NNIiwia2lkIjoiNjZmN2ExYzJlNGIwYTFkMmMzZTRmNWE2IiwicGtmIjoiYTk1YWRiNGE2NTAwOTdmMzk1YTcyZDE0M2M4OGFjZmYxZDdmNzE3OTlkYzZmNDFiNjhiZDU5YmQzMGI1Mjc0MiJ9",
"encrypted_key": "CYZa0douXIvcxdFpLN93tTs84XAkpHSBv9cCmiIoL7NgSdIhH3zn31vC0pnzWSKzIlZzrAPOQSRj7DNYY1wUM7q66HqYLeB0Z4fQaJ-WRpTNoP4i7rO-EB4lSQTMo8hm0gPFIY1QuiMv5QBVqqYMpyE32keFnj_JjC3YIN9QwyvyDScEbJ6nCqG9etkkpS_yHBRDP7vgtzBWT0MEuE2Xotu4fLV7WHDtNrS5FjpTE6FdaRPHnqs4mFtrmJaGWZzBdp5ssIffrS8OzXPo-eAW9NIZzzY3LnrNm0LeC5Rke9SBRh-EhP7ggHv_GlhM13v8d-qfFjeD15CIRZTU5UmnIA",
"iv": "N2dEX08LzFPtTZiA",
"ciphertext": "nZsJoUJj3bjdddpTOa--ww",
"tag": "OUVK4WI9pnx0vPxB5dxZNg"
}{
"error": {
"code": "<string>",
"message": "<string>",
"details": {}
},
"success": false,
"message": "<string>",
"required": "<string>"
}{
"error": {
"code": "<string>",
"message": "<string>",
"details": {}
},
"success": false,
"message": "<string>",
"required": "<string>"
}{
"error": {
"code": "<string>",
"message": "<string>",
"details": {}
},
"success": false,
"message": "<string>",
"required": "<string>"
}{
"error": {
"code": "<string>",
"message": "<string>",
"details": {}
},
"success": false,
"message": "<string>",
"required": "<string>"
}{
"error": {
"code": "<string>",
"message": "<string>",
"details": {}
},
"success": false,
"message": "<string>",
"required": "<string>"
}{
"error": {
"code": "<string>",
"message": "<string>",
"details": {}
},
"success": false,
"message": "<string>",
"required": "<string>"
}{
"error": {
"code": "<string>",
"message": "<string>",
"details": {}
},
"success": false,
"message": "<string>",
"required": "<string>"
}{
"error": {
"code": "<string>",
"message": "<string>",
"details": {}
},
"success": false,
"message": "<string>",
"required": "<string>"
}{
"error": {
"code": "<string>",
"message": "<string>",
"details": {}
},
"success": false,
"message": "<string>",
"required": "<string>"
}POST endpoint when the request parameters must be encrypted. When request encryption is enabled for the Platform Key, send the LlmLedgerQueryBody as an encrypted JWE. When response encryption is enabled, the endpoint also returns the response as an encrypted JWE, including error responses after the API key has been authenticated.
Set Content-Type to application/json or application/jose+json. Don’t add a query string to the request.
To filter by end user, send channelUId as a JSON array or as a comma-separated string. Each array entry is one value and isn’t split on commas. This is the recommended way to look up an end user, because the identifier stays out of URLs that proxies and access logs can record. For the format rules, limits, and errors, see Filter by end user.
The endpoint returns individual LLM calls rather than aggregating calls by conversation turn. You can use dataMode to return either call-level details or, with full, the stored prompt and response payloads when available.Authorizations
Body
- Option 1
- Option 2
POST form of the GET query parameters: a flat JSON object whose keys are the
GET query parameter names. For a Platform Key with request encryption on, send
this object encrypted as an EncryptedRequest instead.
Same as the channel query parameter of the GET operation.
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 Same as the source query parameter of the GET operation.
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 Same as the sourceSubtype query parameter of the GET operation.
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 Same as the channelType query parameter of the GET operation.
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 Same as the channelUId query parameter of the GET operation. Send a JSON array, or a comma-separated string as in the query string. Each array entry is one value and is never split on commas. This POST form is the recommended way to look up an end user, because the identifier stays out of URLs that proxies and access logs may record.
1 - 100 elements1 - 512Response
LLM ledger page returned successfully (same body as the GET form).
- Option 1
- Option 2
Was this page helpful?