Get a single trace by ID

curl --request GET \
  --url https://api.avidoai.com/v0/traces/{id} \
  --header 'x-api-key: <api-key>' \
  --header 'x-application-id: <api-key>'

{
  "data": {
    "id": "123e4567-e89b-12d3-a456-426614174000",
    "traceId": "thread_abc",
    "applicationId": "app_123",
    "timestamp": "2025-01-05T12:34:56.789Z",
    "type": "llm",
    "event": "start",
    "tokens": {
      "input": 100,
      "output": 200
    },
    "metadata": {
      "custom": "metadata"
    }
  }
}

GET

traces

{id}

Get a single trace by ID

curl --request GET \
  --url https://api.avidoai.com/v0/traces/{id} \
  --header 'x-api-key: <api-key>' \
  --header 'x-application-id: <api-key>'

{
  "data": {
    "id": "123e4567-e89b-12d3-a456-426614174000",
    "traceId": "thread_abc",
    "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

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).

Show child attributes

data.id

string<uuid>

required

Unique Trace ID (UUID).

Example:

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

data.timestamp

string

required

ISO-8601 datetime with up to microsecond precision (e.g., 2025-01-05T12:34:56.789123Z). Numeric millisecond timestamps (number or numeric string) are also accepted and automatically converted.

Example:

"2025-01-05T12:34:56.789123Z"

data.referenceId

string

An optional reference ID to link the trace to an existing conversation or interaction in your own database.

Example:

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

data.metadata

Arbitrary metadata (e.g., userId, source). String inputs are parsed as JSON or wrapped in { raw: val }.

Show child attributes

data.metadata.{key}

any

Example:

{ "userId": "123", "source": "chatbot" }

data.testId

string

The associated Test if this was triggered by an Avido eval

data.steps

The steps associated with the trace.

Start of an LLM trace.

Show child attributes

data.steps.id

string<uuid>

required

UUID for the step.

Example:

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

data.steps.traceId

string<uuid>

required

UUID referencing the parent trace's ID.

Example:

"610adba1-7cc0-4fa7-9e2b-8bd2fdf281b2"

data.steps.timestamp

string

required

ISO-8601 datetime with up to microsecond precision (e.g., 2025-01-05T12:34:56.789123Z). Numeric millisecond timestamps (number or numeric string) are also accepted and automatically converted.

Example:

"2025-01-05T12:34:56.789123Z"

data.steps.type

enum<string>

required

Available options:

llm

data.steps.modelId

string

required

Model ID or name used for the LLM call.

Example:

"gpt-4o-2024-08-06"

data.steps.event

enum<string>

required

Available options:

start

data.steps.input

string

required

JSON input for this LLM trace event (e.g., the prompt).

Example:

"Tell me a joke."

data.steps.name

string

The name of the step.

Example:

"Moderation"

data.steps.group

string

Optionally, the key for a group step to group the step with.

Example:

"inputModeration"

data.steps.params

Arbitrary params for the step.

Show child attributes

data.steps.params.{key}

any

data.steps.metadata

Extra metadata about this trace event. String values are parsed as JSON if possible, otherwise wrapped in { raw: val }.

Show child attributes

data.steps.metadata.{key}

any

List Traces Ingest events

⌘I

Webhook

Applications

Threads

Ingestion

Tasks

Task Schedules

Eval Definitions

Experiments

Inference Steps

Evals

Tests

Topics

Annotations

Issues

Runs

Style Guides

Documents

Document Chunks

Document Versions

Tags

Document Tags

Task Tags

Scrape Jobs

Quickstarts

Get a single trace by ID

Authorizations

Path Parameters

Response