Rest API
OpenInference SDK
curl --request GET \
--url https://api.example.com/v1/projects/{project_identifier}/spans{
"data": [
{
"name": "<string>",
"context": {
"trace_id": "<string>",
"span_id": "<string>"
},
"span_kind": "<string>",
"start_time": "2023-11-07T05:31:56Z",
"end_time": "2023-11-07T05:31:56Z",
"status_code": "<string>",
"id": "",
"parent_id": "<string>",
"status_message": "",
"attributes": {},
"events": [
{
"name": "<string>",
"timestamp": "2023-11-07T05:31:56Z",
"attributes": {}
}
]
}
],
"next_cursor": "<string>"
}List spans with simple filters (no DSL)
Return spans within a project filtered by time range. Supports cursor-based pagination.
curl --request GET \
--url https://api.example.com/v1/projects/{project_identifier}/spans{
"data": [
{
"name": "<string>",
"context": {
"trace_id": "<string>",
"span_id": "<string>"
},
"span_kind": "<string>",
"start_time": "2023-11-07T05:31:56Z",
"end_time": "2023-11-07T05:31:56Z",
"status_code": "<string>",
"id": "",
"parent_id": "<string>",
"status_message": "",
"attributes": {},
"events": [
{
"name": "<string>",
"timestamp": "2023-11-07T05:31:56Z",
"attributes": {}
}
]
}
],
"next_cursor": "<string>"
}Documentation Index
Fetch the complete documentation index at: https://arizeai-433a7140.mintlify.app/llms.txt
Use this file to discover all available pages before exploring further.
Path Parameters
The project identifier: either project ID or project name. If using a project name, it cannot contain slash (/), question mark (?), or pound sign (#) characters.
Query Parameters
Pagination cursor (Span Global ID)
Maximum number of spans to return
x <= 1000Inclusive lower bound time
Exclusive upper bound time
Filter by one or more trace IDs
Filter by parent span ID. Use "null" to get root spans only.
Filter by span name(s)
Filter by span kind(s). Values: LLM, CHAIN, TOOL, RETRIEVER, EMBEDDING, AGENT, RERANKER, GUARDRAIL, EVALUATOR, UNKNOWN
Filter by status code(s). Values: OK, ERROR, UNSET
Filter spans by key:value. Key is a dot-path (e.g. user.id, metadata.tier). Value is JSON-parsed: k:12345 is int, k:true is bool, otherwise string (k:user-42). To match a numeric- or boolean-looking STRING, JSON-quote it: user.id:"12345" (URL-encoded %2212345%22). Split is on the first : only, so values may contain colons (session.id:sess:abc:123, ISO timestamps). Repeat the param to AND filters. List-valued attributes (e.g. tag.tags) cannot be matched here. Returns 422 on malformed input (missing colon, empty key/value, or list/dict/null value).
Was this page helpful?