List Traces

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

{
  "data": [
    {
      "id": "123e4567-e89b-12d3-a456-426614174000",
      "timestamp": "2025-01-05T12:34:56.789123Z",
      "referenceId": "123e4567-e89b-12d3-a456-426614174000",
      "metadata": {
        "userId": "123",
        "source": "chatbot"
      },
      "testId": "<string>",
      "steps": [
        {
          "id": "123e4567-e89b-12d3-a456-426614174000",
          "traceId": "610adba1-7cc0-4fa7-9e2b-8bd2fdf281b2",
          "timestamp": "2025-01-05T12:34:56.789123Z",
          "type": "llm",
          "modelId": "gpt-4o-2024-08-06",
          "event": "start",
          "input": "Tell me a joke.",
          "name": "Moderation",
          "group": "inputModeration",
          "params": {},
          "metadata": {}
        }
      ]
    }
  ],
  "pagination": {
    "skip": 0,
    "limit": 25,
    "total": 100,
    "totalPages": 4
  }
}

GET

traces

List Traces

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

{
  "data": [
    {
      "id": "123e4567-e89b-12d3-a456-426614174000",
      "timestamp": "2025-01-05T12:34:56.789123Z",
      "referenceId": "123e4567-e89b-12d3-a456-426614174000",
      "metadata": {
        "userId": "123",
        "source": "chatbot"
      },
      "testId": "<string>",
      "steps": [
        {
          "id": "123e4567-e89b-12d3-a456-426614174000",
          "traceId": "610adba1-7cc0-4fa7-9e2b-8bd2fdf281b2",
          "timestamp": "2025-01-05T12:34:56.789123Z",
          "type": "llm",
          "modelId": "gpt-4o-2024-08-06",
          "event": "start",
          "input": "Tell me a joke.",
          "name": "Moderation",
          "group": "inputModeration",
          "params": {},
          "metadata": {}
        }
      ]
    }
  ],
  "pagination": {
    "skip": 0,
    "limit": 25,
    "total": 100,
    "totalPages": 4
  }
}

Authorizations

x-api-key

string

header

required

Your unique Avido API key

x-application-id

string

header

required

Your unique Avido Application ID

Query Parameters

skip

integer

default:0

Number of items to skip before starting to collect the result set.

Required range: x >= 0

Example:

0

limit

integer

default:25

Number of items to include in the result set.

Required range: 1 <= x <= 100

Example:

25

applicationId

string<uuid>

required

Filter traces by application ID

Example:

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

startDate

string<date-time>

Start date (ISO8601) for filtering traces.

Example:

"2025-01-09T14:47:56Z"

endDate

string<date-time>

End date (ISO8601) for filtering traces.

Example:

"2025-01-09T14:47:56Z"

Response

Successfully retrieved traces with steps

Paginated response containing traces

data

Trace · object[]

required

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

pagination

PaginationResponse · object

required

Pagination metadata returned in a paginated response.

Show child attributes

pagination.skip

integer

required

Number of items skipped.

Required range: x >= 0

Example:

0

pagination.limit

integer

required

Number of items per page.

Required range: x >= 1

Example:

25

pagination.total

integer

required

Total number of items available.

Required range: x >= 0

Example:

100

pagination.totalPages

integer

required

Total number of pages available.

Required range: x >= 0

Example:

4

Get API keys for an application Get a single trace by ID

⌘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

List Traces

Authorizations

Query Parameters

Response