curl --request POST \
  --url https://{host}/api/public/analytics/projects/{projectId}/traces \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: <api-key>' \
  --data '
{
  "fromDate": "2026-08-05T00:00:00.000Z",
  "toDate": "2026-08-06T00:00:00.000Z",
  "eventTypes": [
    "llm",
    "tool"
  ],
  "dataMode": "summary",
  "sortOrder": "desc",
  "limit": 100
}
'

{
  "protected": "eyJhbGciOiJSU0EtT0FFUC0yNTYiLCJlbmMiOiJBMjU2R0NNIiwia2lkIjoiNjZmN2ExYzJlNGIwYTFkMmMzZTRmNWE2IiwicGtmIjoiZDExYzNlNDcxYjRmNDU4MTA3Y2JiZmFjMzg2NWEwNDZhMjIyZjVlZDcyZDQ2MDUyNDFiMWFjYWI3MjE1MmNlNiJ9",
  "encrypted_key": "XScVR_HSab2Vl58k_P_5xmQaWutTpDzp7oc-1OZXrn6pLVBPx7Z2holovT7U1QWQQeWJVOKIchjQJV2eDtX1wT11kusoQMrgDsgk1kaNgxzQSgiECQUkGJnjCJCzp_wSKiYTpwshpYKYLNjo1lQBCk97ukApMmym_GUBERGQkOhc53bFVEXNd8UFZMrn7-wkChOHbwm5DbMJVboNK9Pqe4InWQRFpg6gaxIqH9XM4bkhydQUxTxwJtvY3fmKhMpT7ZeEbclUCGAHK_xUVLj9yzSadjgDoYT04DetRleOQrjBfC_qr8t3ilWZlpIeqiET5iyEFrxuhqi9zzUIs_6Njw",
  "iv": "Nd51pTVdZKYz8Lt6",
  "ciphertext": "mIzOWlsoKAPVc3lQghwjHA",
  "tag": "BaHsLsjLXYGESMoRsNdr4g"
}

{
  "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 trace events using JWE payload

POST form of GET on this path. It accepts the same parameters as a flat JSON body (TracesQueryBody) instead of a query string, and returns the same response. Use it when the request parameters must be encrypted. See “Sending parameters in a POST body” and “Payload encryption” in the API description.

Request encryption off: send TracesQueryBody as application/json.
Request encryption on: send the same object encrypted as an EncryptedRequest, preferably as application/jose+json.
Response encryption on: every response except 401 is an EncryptedResponse with X-ABL-Encrypted: true.

POST

api

public

analytics

projects

{projectId}

traces

curl --request POST \
  --url https://{host}/api/public/analytics/projects/{projectId}/traces \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: <api-key>' \
  --data '
{
  "fromDate": "2026-08-05T00:00:00.000Z",
  "toDate": "2026-08-06T00:00:00.000Z",
  "eventTypes": [
    "llm",
    "tool"
  ],
  "dataMode": "summary",
  "sortOrder": "desc",
  "limit": 100
}
'

{
  "protected": "eyJhbGciOiJSU0EtT0FFUC0yNTYiLCJlbmMiOiJBMjU2R0NNIiwia2lkIjoiNjZmN2ExYzJlNGIwYTFkMmMzZTRmNWE2IiwicGtmIjoiZDExYzNlNDcxYjRmNDU4MTA3Y2JiZmFjMzg2NWEwNDZhMjIyZjVlZDcyZDQ2MDUyNDFiMWFjYWI3MjE1MmNlNiJ9",
  "encrypted_key": "XScVR_HSab2Vl58k_P_5xmQaWutTpDzp7oc-1OZXrn6pLVBPx7Z2holovT7U1QWQQeWJVOKIchjQJV2eDtX1wT11kusoQMrgDsgk1kaNgxzQSgiECQUkGJnjCJCzp_wSKiYTpwshpYKYLNjo1lQBCk97ukApMmym_GUBERGQkOhc53bFVEXNd8UFZMrn7-wkChOHbwm5DbMJVboNK9Pqe4InWQRFpg6gaxIqH9XM4bkhydQUxTxwJtvY3fmKhMpT7ZeEbclUCGAHK_xUVLj9yzSadjgDoYT04DetRleOQrjBfC_qr8t3ilWZlpIeqiET5iyEFrxuhqi9zzUIs_6Njw",
  "iv": "Nd51pTVdZKYz8Lt6",
  "ciphertext": "mIzOWlsoKAPVc3lQghwjHA",
  "tag": "BaHsLsjLXYGESMoRsNdr4g"
}

{
  "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>"
}

Use this endpoint when you need the same trace data and filtering capabilities as the corresponding GET endpoint, but want to send the query parameters in the request body instead of the URL. The POST endpoint accepts the same parameters and returns the same response as GET. When request encryption is enabled for the Platform Key, send the TracesQueryBody as an encrypted JWE. When request encryption is disabled, send the same parameters as a plain JSON object. Response encryption is independent of request encryption; when enabled, responses other than 401 are returned as encrypted JWE payloads. The POST endpoint supports the same filtering parameters as GET. The POST body uses the GET parameter names as JSON property names. List parameters can be sent as JSON arrays or comma-separated strings. traceDimensions is not a parameter in this Traces API; do not use it with this endpoint. Use POST method when:

You must encrypt the request parameters.
You want to avoid exposing potentially sensitive filter values in the URL.
You need to send the query as a JSON object rather than URL query parameters.

When request encryption is enabled, the plaintext query object is encrypted as a flattened JWE using the configured Platform Key. A plaintext POST body is rejected when request encryption is enabled, while an encrypted body is rejected when request encryption is disabled. Do not add query parameters to a POST request. All query parameters must be supplied in the request body.

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

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.

fromDate

string<date-time>

required

Same as the fromDate query parameter of the GET operation.

toDate

string<date-time>

required

Same as the toDate query parameter of the GET operation.

limit

integer

default:100

Same as the limit query parameter of the GET operation.

Required range: 1 <= x <= 10000

cursor

string

Same as the cursor query parameter of the GET operation.

Minimum string length: 1

eventTypes

Same as the eventTypes query parameter of the GET operation. Send a JSON array, or a comma-separated string as in the query string.

Maximum array length: 4

Available options:

llm,

tool,

decision,

error

eventNames

Same as the eventNames query parameter of the GET operation. Send a JSON array, or a comma-separated string as in the query string.

Maximum array length: 20

Available options:

llm.call.completed,

llm.call.failed,

tool.call.completed,

tool.call.failed,

tool.call.skipped,

agent.decision

sessionIds

Same as the sessionIds query parameter of the GET operation. Send a JSON array, or a comma-separated string as in the query string.

Maximum array length: 10000

Minimum string length: 1

eventId

string

Same as the eventId query parameter of the GET operation.

Minimum string length: 1

traceId

string

Same as the traceId query parameter of the GET operation.

Minimum string length: 1

agentName

string

Same as the agentName query parameter of the GET operation.

Minimum string length: 1

decisionKind

string

Same as the decisionKind query parameter of the GET operation.

Minimum string length: 1

channel

enum<string>

Same as the channel query parameter of the GET operation.

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

environment

enum<string>

Same as the environment query parameter of the GET operation.

Available options:

dev,

staging,

production,

working-copy

hasError

boolean

Same as the hasError query parameter of the GET operation.

dataMode

enum<string>

default:summary

Same as the dataMode query parameter of the GET operation.

Available options:

summary,

full

sortOrder

enum<string>

default:asc

Same as the sortOrder query parameter of the GET operation.

Available options:

asc,

desc

Response

Trace event page returned successfully (same body as the GET form).

Option 1
Option 2

traces

object[]

required

The traces on this page. One trace groups the events from a single run.

Show child attributes

pageInfo

object

required

Paging information for this response.

Show child attributes

APIs

SDKs

List trace events using JWE payload

Authorizations

Path Parameters

Body

Response