Traces

Trace lookup endpoints.

List traces

get

List traces within the authenticated project.

Authorizations

ApiKeyAuth

AuthorizationstringRequired

API key in Authorization header using Bearer .

Query parameters

limitinteger · min: 1 · max: 100OptionalDefault: 20

offsetintegerOptionalDefault: 0

Responses

200

Successful Response

application/json

List response for project-scoped traces.

objectconst: listOptional

Object type identifier.

Default: list

totalintegerRequired

Total number of items available for this resource.

400

Bad Request

application/json

401

Unauthorized

application/json

403

Forbidden

application/json

422

Validation Error

application/json

429

Too Many Requests

application/json

500

Internal Server Error

application/json

501

Not Implemented

application/json

503

Upstream Unavailable

application/json

get

/v1/traces

HTTPcURLJavaScriptPython

GET /v1/traces HTTP/1.1
Host: platform.maniac.ai
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

{
  "object": "list",
  "data": [
    {
      "container_count": 2,
      "error_count": 1,
      "first_seen": "2026-03-18T12:00:00Z",
      "id": "tr_customer_followup_123",
      "last_seen": "2026-03-18T12:00:04Z",
      "name": "customer-followup",
      "request_count": 3,
      "source": "my-app",
      "spend": 12345,
      "success_count": 2
    }
  ],
  "total": 0
}

Get a trace

get

Fetch a single trace by external trace id (trace.id) within the authenticated project.

Authorizations

ApiKeyAuth

AuthorizationstringRequired

API key in Authorization header using Bearer .

Path parameters

idstringRequired

Responses

200

Successful Response

application/json

idstringRequired

External trace identifier (trace.id).

nameany ofOptional

Optional trace name.

stringOptional

or

nullOptional

sourceany ofOptional

Optional trace source.

stringOptional

or

nullOptional

trace_contextany ofOptional

Most recent normalized trace context stored for this trace.

or

nullOptional

first_seenany ofOptional

Timestamp of the first request recorded for this trace.

string · date-timeOptional

or

nullOptional

last_seenany ofOptional

Timestamp of the most recent request recorded for this trace.

string · date-timeOptional

or

nullOptional

request_countintegerRequired

Number of inference log rows recorded for this trace.

container_countintegerRequired

Number of distinct containers involved in this trace.

error_countintegerRequired

Number of errored requests recorded for this trace.

400

Bad Request

application/json

401

Unauthorized

application/json

403

Forbidden

application/json

404

Not Found

application/json

422

Validation Error

application/json

429

Too Many Requests

application/json

500

Internal Server Error

application/json

503

Upstream Unavailable

application/json

get

/v1/traces/{id}

HTTPcURLJavaScriptPython

GET /v1/traces/{id} HTTP/1.1
Host: platform.maniac.ai
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

{
  "container_count": 2,
  "error_count": 1,
  "first_seen": "2026-03-18T12:00:00Z",
  "id": "tr_customer_followup_123",
  "last_seen": "2026-03-18T12:00:04Z",
  "name": "customer-followup",
  "request_count": 3,
  "source": "my-app",
  "spans": [
    {
      "attempt_count": 2,
      "container_count": 1,
      "first_seen": "2026-03-18T12:00:01Z",
      "inference_log_ids": [
        "7a2cb0d6-d04b-4b45-bfbb-9c7d18850f22",
        "dbce54ce-411f-4ad7-b3aa-09aa66cc70ea"
      ],
      "last_seen": "2026-03-18T12:00:04Z",
      "latest_inference_log_id": "dbce54ce-411f-4ad7-b3aa-09aa66cc70ea",
      "latest_status": "success",
      "parent_span_id": "planner",
      "span_id": "writer"
    }
  ],
  "trace_context": {
    "id": "tr_customer_followup_123",
    "name": "customer-followup",
    "source": "my-app"
  }
}