Spans

Filter on span fields with filters, and sort by evaluator scores. Metadata keys beginning with _ are reserved for platform use and omitted from span and trace read responses.

post/api/request-logs/list/

Request

  • Base URL
    https://api.respan.ai
  • URL
    https://api.respan.ai/api/request-logs/list/
  • Auth
    • HTTP bearer
    • or HTTP bearer

Query parameters

pageinteger

Page number.

page_sizeinteger

Results per page (max 1000).

sort_bystring

Field to sort by. Prefix - for descending.

start_timestring date-time

Start of time range (ISO 8601).

end_timestring date-time

End of time range (ISO 8601).

environment'prod' | 'test'

Filter by environment (prod or test).

log_type'text' | 'chat' | 'completion' | 'response' | 'embedding' | 'transcription' | 'speech' | 'workflow' | 'task' | 'tool' | 'agent' | 'handoff' | 'guardrail' | 'function' | 'custom' | 'generation' | 'unknown' | 'score' | 'batch' | 'span'

Filter by span/log type. Use values like chat, completion, or response to focus on model-inference spans; omitting this can also return non-chat span/log rows such as legacy text logs.

include_fieldsstring

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

Request body

Example request

{
  "filters": {
    "customer_identifier": {
      "operator": "",
      "value": [
        "alex@acme.dev"
      ]
    }
  }
}

Response

Successful response for List spans

countinteger required

Number of results on this page, not the total. Request pages until next is null to get every result.

nextstring nullable

URL for the next page of results

previousstring nullable

URL for the previous page of results

resultsobject[] required

Array of results for the current page

Changes

    • breaking

      the response property became nullable for the status

    • breaking

      the response property became nullable for the status

    • info

      api operation id spans_listSpans removed and replaced with listSpans

    • info

      the endpoint scheme security DashboardJwt was added to the API

    • info

      api tag Spans added

    • info

      api tag spans removed

    • breaking

      removed the enum value iexact of the request property //

    • breaking

      removed the enum value iexact of the request property //

    • breaking

      removed the enum value iexact of the request property //

    • breaking

      removed the enum value iexact of the request property //

    • breaking

      removed the enum value iexact of the request property //

    • breaking

      removed the enum value iexact of the request property //

    • breaking

      removed the enum value iexact of the request property //

    • breaking

      removed the enum value iexact of the request property //

    • breaking

      removed the enum value iexact of the request property //

    • breaking

      removed the enum value iexact of the request property //

    • breaking

      removed the enum value iexact of the request property //

    • breaking

      removed the enum value iexact of the request property //

    • breaking

      removed the enum value iexact of the request property //

    • breaking

      removed the enum value iexact of the request property //

    • breaking

      removed the enum value iexact of the request property //

    • breaking

      removed the enum value iexact of the request property //

    • breaking

      removed the enum value iexact of the request property //

    • breaking

      removed the enum value iexact of the request property //

    • breaking

      removed the enum value iexact of the request property //

    • breaking

      removed the enum value iexact of the request property //

    • breaking

      removed the enum value iexact of the request property //

    • breaking

      removed the enum value iexact of the request property //

    • breaking

      removed the enum value iexact of the request property //

    • breaking

      removed the enum value isnull of the request property //

    • breaking

      removed the enum value isnull of the request property //

    • breaking

      removed the enum value isnull of the request property //

    • breaking

      removed the enum value isnull of the request property //

    • breaking

      removed the enum value isnull of the request property //

    • breaking

      removed the enum value isnull of the request property //

    • breaking

      removed the enum value isnull of the request property //

    • breaking

      removed the enum value isnull of the request property //

    • breaking

      removed the enum value isnull of the request property //

    • breaking

      removed the enum value isnull of the request property //

    • breaking

      removed the enum value isnull of the request property //

    • breaking

      removed the enum value isnull of the request property //

    • breaking

      removed the enum value isnull of the request property //

    • breaking

      removed the enum value isnull of the request property //

    • breaking

      removed the enum value isnull of the request property //

    • breaking

      removed the enum value isnull of the request property //

    • breaking

      removed the enum value isnull of the request property //

    • breaking

      removed the enum value isnull of the request property //

    • breaking

      removed the enum value isnull of the request property //

    • breaking

      removed the enum value isnull of the request property //

    • breaking

      removed the enum value isnull of the request property //

    • breaking

      removed the enum value isnull of the request property //

    • breaking

      removed the enum value isnull of the request property //

    • warning

      removed the request property /

    • warning

      removed the request property /

    • warning

      removed the request property /

    • warning

      removed the request property /

    • warning

      removed the request property /

    • info

      added the new optional request property /

    • info

      added the new optional request property /

    • info

      added the new empty enum value to the request property //

    • info

      added the new empty enum value to the request property //

    • info

      added the new empty enum value to the request property //

    • info

      added the new empty enum value to the request property //

    • info

      added the new empty enum value to the request property //

    • info

      added the new empty enum value to the request property //

    • info

      added the new empty enum value to the request property //

    • info

      added the new empty enum value to the request property //

    • info

      added the new empty enum value to the request property //

    • info

      added the new empty enum value to the request property //

    • info

      added the new empty enum value to the request property //

    • info

      added the new empty enum value to the request property //

    • info

      added the new empty enum value to the request property //

    • info

      added the new empty enum value to the request property //

    • info

      added the new empty enum value to the request property //

    • info

      added the new empty enum value to the request property //

    • info

      added the new empty enum value to the request property //

    • info

      added the new empty enum value to the request property //

    • info

      added the new empty enum value to the request property //

    • info

      added the new empty enum value to the request property //

    • info

      added the new empty enum value to the request property //

    • info

      added the new empty enum value to the request property //

    • info

      added the new empty enum value to the request property //

    • info

      added the new not_contains enum value to the request property //

    • info

      added the new not_contains enum value to the request property //

    • info

      added the new not_contains enum value to the request property //

    • info

      added the new not_contains enum value to the request property //

    • info

      added the new not_contains enum value to the request property //

    • info

      added the new not_contains enum value to the request property //

    • info

      added the new not_contains enum value to the request property //

    • info

      added the new not_contains enum value to the request property //

    • info

      added the new not_contains enum value to the request property //

    • info

      added the new not_contains enum value to the request property //

    • info

      added the new not_contains enum value to the request property //

    • info

      added the new not_contains enum value to the request property //

    • info

      added the new not_contains enum value to the request property //

    • info

      added the new not_contains enum value to the request property //

    • info

      added the new not_contains enum value to the request property //

    • info

      added the new not_contains enum value to the request property //

    • info

      added the new not_contains enum value to the request property //

    • info

      added the new not_contains enum value to the request property //

    • info

      added the new not_contains enum value to the request property //

    • info

      added the new not_contains enum value to the request property //

    • info

      added the new not_contains enum value to the request property //

    • info

      added the new not_contains enum value to the request property //

    • info

      added the new not_contains enum value to the request property //

    • info

      added the new not_empty enum value to the request property //

    • info

      added the new not_empty enum value to the request property //

    • info

      added the new not_empty enum value to the request property //

    • info

      added the new not_empty enum value to the request property //

    • info

      added the new not_empty enum value to the request property //

    • info

      added the new not_empty enum value to the request property //

    • info

      added the new not_empty enum value to the request property //

    • info

      added the new not_empty enum value to the request property //

    • info

      added the new not_empty enum value to the request property //

    • info

      added the new not_empty enum value to the request property //

    • info

      added the new not_empty enum value to the request property //

    • info

      added the new not_empty enum value to the request property //

    • info

      added the new not_empty enum value to the request property //

    • info

      added the new not_empty enum value to the request property //

    • info

      added the new not_empty enum value to the request property //

    • info

      added the new not_empty enum value to the request property //

    • info

      added the new not_empty enum value to the request property //

    • info

      added the new not_empty enum value to the request property //

    • info

      added the new not_empty enum value to the request property //

    • info

      added the new not_empty enum value to the request property //

    • info

      added the new not_empty enum value to the request property //

    • info

      added the new not_empty enum value to the request property //

    • info

      added the new not_empty enum value to the request property //

    • info

      added the new not_endswith enum value to the request property //

    • info

      added the new not_endswith enum value to the request property //

    • info

      added the new not_endswith enum value to the request property //

    • info

      added the new not_endswith enum value to the request property //

    • info

      added the new not_endswith enum value to the request property //

    • info

      added the new not_endswith enum value to the request property //

    • info

      added the new not_endswith enum value to the request property //

    • info

      added the new not_endswith enum value to the request property //

    • info

      added the new not_endswith enum value to the request property //

    • info

      added the new not_endswith enum value to the request property //

    • info

      added the new not_endswith enum value to the request property //

    • info

      added the new not_endswith enum value to the request property //

    • info

      added the new not_endswith enum value to the request property //

    • info

      added the new not_endswith enum value to the request property //

    • info

      added the new not_endswith enum value to the request property //

    • info

      added the new not_endswith enum value to the request property //

    • info

      added the new not_endswith enum value to the request property //

    • info

      added the new not_endswith enum value to the request property //

    • info

      added the new not_endswith enum value to the request property //

    • info

      added the new not_endswith enum value to the request property //

    • info

      added the new not_endswith enum value to the request property //

    • info

      added the new not_endswith enum value to the request property //

    • info

      added the new not_endswith enum value to the request property //

    • info

      added the new not_in enum value to the request property //

    • info

      added the new not_in enum value to the request property //

    • info

      added the new not_in enum value to the request property //

    • info

      added the new not_in enum value to the request property //

    • info

      added the new not_in enum value to the request property //

    • info

      added the new not_in enum value to the request property //

    • info

      added the new not_in enum value to the request property //

    • info

      added the new not_in enum value to the request property //

    • info

      added the new not_in enum value to the request property //

    • info

      added the new not_in enum value to the request property //

    • info

      added the new not_in enum value to the request property //

    • info

      added the new not_in enum value to the request property //

    • info

      added the new not_in enum value to the request property //

    • info

      added the new not_in enum value to the request property //

    • info

      added the new not_in enum value to the request property //

    • info

      added the new not_in enum value to the request property //

    • info

      added the new not_in enum value to the request property //

    • info

      added the new not_in enum value to the request property //

    • info

      added the new not_in enum value to the request property //

    • info

      added the new not_in enum value to the request property //

    • info

      added the new not_in enum value to the request property //

    • info

      added the new not_in enum value to the request property //

    • info

      added the new not_in enum value to the request property //

    • info

      added the new not_startswith enum value to the request property //

    • info

      added the new not_startswith enum value to the request property //

    • info

      added the new not_startswith enum value to the request property //

    • info

      added the new not_startswith enum value to the request property //

    • info

      added the new not_startswith enum value to the request property //

    • info

      added the new not_startswith enum value to the request property //

    • info

      added the new not_startswith enum value to the request property //

    • info

      added the new not_startswith enum value to the request property //

    • info

      added the new not_startswith enum value to the request property //

    • info

      added the new not_startswith enum value to the request property //

    • info

      added the new not_startswith enum value to the request property //

    • info

      added the new not_startswith enum value to the request property //

    • info

      added the new not_startswith enum value to the request property //

    • info

      added the new not_startswith enum value to the request property //

    • info

      added the new not_startswith enum value to the request property //

    • info

      added the new not_startswith enum value to the request property //

    • info

      added the new not_startswith enum value to the request property //

    • info

      added the new not_startswith enum value to the request property //

    • info

      added the new not_startswith enum value to the request property //

    • info

      added the new not_startswith enum value to the request property //

    • info

      added the new not_startswith enum value to the request property //

    • info

      added the new not_startswith enum value to the request property //

    • info

      added the new not_startswith enum value to the request property //

    • info

      added the non-success response with the status

    • info

      removed the non-success response with the status