Skip to main content
GET
/
v0
/
traces
/
by-test
/
{id}
Get a single trace by Test ID
curl --request GET \
  --url https://api.avidoai.com/v0/traces/by-test/{id} \
  --header 'x-api-key: <api-key>' \
  --header 'x-application-id: <api-key>'
{
  "data": {
    "id": "123e4567-e89b-12d3-a456-426614174000",
    "traceId": "789e4567-e89b-12d3-a456-426614174000",
    "applicationId": "app_123",
    "timestamp": "2025-01-05T12:34:56.789Z",
    "type": "llm",
    "event": "start",
    "tokens": {
      "input": 100,
      "output": 200
    },
    "metadata": {
      "custom": "metadata"
    }
  }
}

Authorizations

​
x-api-key
string
header
required

Your unique Avido API key

​
x-application-id
string
header
required

Your unique Avido Application ID

Path Parameters

​
id
string<uuid>
required

The unique identifier of the trace

Example:

"123e4567-e89b-12d3-a456-426614174000"

Response

Successfully retrieved trace

Successful response containing a single trace object

​
data
Trace · object
required

A trace grouping related steps (e.g. a user-agent interaction or conversation).