a13nDocs
API referenceRuns

Search Traces

Rank and filter the entire root-start window before paging. Costs sum reported span costs, not billing. Providers execute each query without a result cache; pages may reflect updates between requests. Keyset cursors bind the ordering, filters and last sort value with trace/span IDs. Incomplete queries fail without a partial rank.

GET/api/v1/traces/search

Rank and filter the entire root-start window before paging. Costs sum reported span costs, not billing.

Providers execute each query without a result cache; pages may reflect updates between requests. Keyset cursors bind the ordering, filters and last sort value with trace/span IDs. Incomplete queries fail without a partial rank.

Authorization

AuthorizationBearer <token>

A workspace API key (a13n_...)

In: header

Query Parameters

session_id?|null
thread_id?|null
run_id?|null
attribute?array<string>
Itemsitems <= 8
started_after*Started After
Formatdate-time
started_before*Started Before
Formatdate-time
order_by?Order By
Default"started"

Value in

  • "started"
  • "duration"
  • "cost"
direction?Direction
Default"desc"

Value in

  • "asc"
  • "desc"
min_duration_seconds?||null
max_duration_seconds?||null
min_cost_usd?||null
max_cost_usd?||null
limit?Limit
Range1 <= value <= 100
Default25
cursor?string|null

Header Parameters

X-Workspace-ID?|

The workspace ID a login session acts in; required with a login session. An API key acts in its own workspace and needs none; naming another is forbidden.

Response Body

application/json

application/json

application/json

curl -X GET "https://example.com/api/v1/traces/search?started_after=2019-08-24T14%3A15%3A22Z&started_before=2019-08-24T14%3A15%3A22Z"
{  "collected_at": "2019-08-24T14:15:22Z",  "items": [    {      "cost_usd": "string",      "duration_seconds": "string",      "root": {        "attributes": {          "property1": null,          "property2": null        },        "cost_usd": "string",        "ended_at": "2019-08-24T14:15:22Z",        "events": [          {            "attributes": {              "property1": null,              "property2": null            },            "name": "string",            "timestamp": "2019-08-24T14:15:22Z"          }        ],        "id": "string",        "input": null,        "kind": "string",        "level": "string",        "links": [          {            "attributes": {              "property1": null,              "property2": null            },            "span_id": "string",            "trace_id": "string"          }        ],        "model": "string",        "name": "string",        "output": null,        "parent_id": "string",        "resource_attributes": {          "property1": null,          "property2": null        },        "scope": {          "name": "string",          "version": "string"        },        "source_url": "string",        "started_at": "2019-08-24T14:15:22Z",        "status": "ok",        "status_message": "string",        "trace_id": "string",        "usage": {          "property1": 0,          "property2": 0        }      }    }  ],  "next_cursor": "string",  "total": 0}