List spans (legacy) | Respan Docs

List spans via the legacy endpoint. This path supports basic pagination and filtering, but for advanced filtering, annotations, and evaluator score sorting, use /api/request-logs/list/ instead.

Query parameters

pageintegerOptionalDefaults to 1

Page number.

page_sizeintegerOptional<=1000Defaults to 100

Results per page (max 1000).

sort_bystringOptionalDefaults to -timestamp

Field to sort by. Prefix - for descending.

start_timedatetimeOptional

Start of time range (ISO 8601).

end_timedatetimeOptional

End of time range (ISO 8601).

customer_identifierstringOptional

Filter by end-user/customer identifier.

include_fieldsstringOptional

Comma-separated list of fields to include in each span. Reduces response size.

Response

Paginated legacy span list

countinteger

Total number of matching spans.

resultslist of objects

Array of span objects for the current page.

nextstring or null

URL for the next page of results.

previousstring or null

URL for the previous page of results.

Errors

401

Unauthorized Error

1	curl -G https://api.respan.ai/api/request-logs/ \
2	-H "Authorization: Bearer sk_live_xxxxx" \
3	-d page=1 \
4	-d page_size=100 \
5	-d sort_by=-timestamp \
6	--data-urlencode start_time=2025-01-01T00:00:00Z \
7	--data-urlencode end_time=2025-01-31T23:59:59Z \
8	-d customer_identifier=user_123 \
9	--data-urlencode include_fields=id,cost,latency,customer_identifier

1	{
2	"count": 1250,
3	"results": [
4	{
5	"id": "log_abc123...",
6	"customer_identifier": "user_123",
7	"model": "gpt-4o-mini",
8	"status": "success",
9	"cost": 0.000705,
10	"timestamp": "2026-03-25T10:30:00Z"
11	}
12	],
13	"next": "https://api.respan.ai/api/request-logs/?page=2"
14	}

Headers

Query parameters

Response

Errors