Spans

Get span summary

Changed on

Returns aggregate span statistics for a time range. Send start_time, end_time, and environment as query parameters, and additional filters in the JSON body. Fields such as log_type are not read from query parameters. Empty or omitted filters may use pre-aggregated data; non-empty filters query individual spans using the List spans filter format.

post/api/request-logs/summary/

Request

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

Query parameters

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).

Request body

Example request

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

Response

Summary statistics for matching spans.

number_of_requestsinteger required

Total number of matching spans/log rows.

total_costnumber required

Total cost in USD for all matching spans/log rows.

total_tokensinteger required

Total tokens across all matching spans/log rows.

total_prompt_tokensinteger required

Total prompt/input tokens.

total_completion_tokensinteger required

Total completion/output tokens.

avg_latencynumber required

Average latency in seconds.

avg_tpsnumber required

Average tokens per second.

avg_ttftnumber required

Average time to first token in seconds.

scoresobject required

Aggregated score summaries grouped by evaluator ID.

Example response

{
  "number_of_requests": 1,
  "total_cost": 0,
  "total_tokens": 0,
  "total_prompt_tokens": 0,
  "total_completion_tokens": 0,
  "avg_latency": 0,
  "avg_tps": 0,
  "avg_ttft": 0,
  "scores": {}
}

Changes

    • breaking

      the response's property format changed from double to no format for status

    • breaking

      the response's property format changed from double to no format for status

    • breaking

      the response's property format changed from double to no format for status

    • breaking

      the response's property format changed from double to no format for status

    • info

      api operation id spans_getSpansSummary removed and replaced with getSpansSummary

    • 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