KEkeywordsai
Spans

Get a span

Changed on

Returns the full span, including evaluation scores and credit and budget information (limit_info). Metadata keys beginning with _ are reserved for platform use and omitted from span and trace read responses.

get/api/request-logs/{unique_id}/

Request

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

Path parameters

unique_idstring required

The unique ID of the log to get.

Response

Successful response for Retrieve span

idstring required

Span ID (alias of unique_id).

unique_idstring

Stored unique span ID.

span_unique_idstring

Tracing span ID, when supplied.

trace_unique_idstring

Parent trace ID.

span_namestring

Span name.

span_parent_idstring

Parent span ID.

span_workflow_namestring

Workflow name associated with the span.

timestampstring date-time

Completion timestamp.

start_timestring date-time

Start timestamp.

period_startstring date-time

Billing/aggregation period start.

period_endstring date-time

Billing/aggregation period end.

prompt_messagesobject[]
completion_messageobject
full_requestobject

Credential-sanitized full request.

full_responseobject

Credential-sanitized full response.

modelstring

Model used by the span.

provider_idstring

Provider route used by the span.

environmentstring

API-key environment.

log_typestring

Span/log type.

log_methodstring

How this span was ingested.

statusstring

Span status.

status_codeinteger

HTTP or application status code.

error_codestring

Normalized error code.

error_messagestring

Error message, when the span failed.

prompt_tokensinteger

Input token count.

completion_tokensinteger

Output token count.

total_request_tokensinteger

Total token count.

prompt_cache_hit_tokensinteger

Cached input-token count.

prompt_cache_creation_tokensinteger

Cache-creation input-token count.

reasoning_tokensinteger

Reasoning-token count.

costnumber

Cost in USD.

latencynumber

End-to-end latency in seconds.

time_to_first_tokennumber

Time to first token in seconds.

tokens_per_secondnumber

Output throughput.

routing_timenumber

Gateway routing time.

metadataobject

Customer metadata. Keys beginning with _ are reserved and omitted from customer-facing responses.

variablesobject
toolsobject[]
tool_callsobject[]
scoresobject

Evaluation scores keyed by evaluator identifier or slug.

customer_identifierstring

End-customer identifier.

customer_emailstring

End-customer email.

customer_namestring

End-customer name.

custom_identifierstring

Indexed custom identifier.

group_identifierstring

Group identifier.

session_identifierstring

Session identifier.

thread_identifierstring

Conversation thread identifier.

organization_idstring

Organization UUID.

unique_organization_idstring

Organization UUID.

organization_key_idstring

API-key identifier.

organization_key_namestring

API-key display name.

prompt_idstring

Prompt family ID.

prompt_namestring

Prompt display name.

prompt_version_numberinteger

Prompt version number.

deployment_idstring

Deployment ID.

deployment_namestring

Deployment name.

streamboolean

Whether the response streamed.

temperaturenumber

Sampling temperature.

top_pnumber

Nucleus-sampling parameter.

max_tokensinteger

Configured generation limit.

response_formatobject
blurredboolean

When true, usage policy reduced the response to visibility-safe fields.

Changes

  • c30bcb383ee8Revision changes
    • breaking

      the response property // became nullable for the status

    • breaking

      the response property // became nullable for the status

    • breaking

      the response property // became nullable for the status

    • breaking

      the response property // became nullable for the status

    • breaking

      the response property // became nullable for the status

    • breaking

      the response property // became nullable for the status

    • breaking

      the response property // became nullable for the status

    • breaking

      the response property // became nullable for the status

    • breaking

      the response property // became nullable for the status

    • breaking

      added subschema #2 subschema #3 subschema #4 to the response property oneOf list for the response status

    • breaking

      added subschema #2 subschema #3 subschema #4 to the response property oneOf list for the response status

    • breaking

      added subschema #2 subschema #3 subschema #4 to the response property oneOf list for the response status

    • breaking

      added subschema #2 subschema #3 subschema #4 to the response property oneOf list for the response 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

    • 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 type changed from number null to number, and format 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

    • breaking

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

    • info

      api operation id spans_retrieveSpan removed and replaced with retrieveSpan

    • info

      the endpoint scheme security DashboardJwt was added to the API

    • info

      api tag Spans added

    • info

      api tag spans removed

    • info

      removed subschema #1 subschema #2 from the // response property oneOf list for the response status

    • info

      removed subschema #2 subschema #3 subschema #4 from the response property oneOf list for the response status

    • info

      removed subschema #2 subschema #3 subschema #4 from the response property oneOf list for the response status

    • info

      removed subschema #2 subschema #3 subschema #4 from the response property oneOf list for the response status

    • info

      removed subschema #2 subschema #3 subschema #4 from the response property oneOf list for the response status

  • b830b79cfd52Revision changes
    • warning

      removed the optional property from the response with the status

    • info

      added the non-success response with the status

    • info

      removed the non-success response with the status

    • info

      added the required property to the response with the status