v3
latestOpenAPI 3.1.02026-07-311,4541,5202.3 MBspans
List Spans
POST handler with superadmin-only field protection.
Strips superadmin-only fields from non-superadmin requests before delegating to OrganizationInjectionMixin.post() for org injection.
post/api/request-logs/list/
Headers
Authorizationstring required
Use your Respan API key for Respan API authentication. Enter only the Respan API key value; clients send Authorization: Bearer <RESPAN_API_KEY>. For /api/responses, provider credentials such as Perplexity, OpenAI, or Azure OpenAI go in Settings -> Providers or respan_params.credential_override in the request body, not in this authentication field.
Request body
idstring required
organization_idstring
unique_organization_idstring
error_messagestring
{"stackTrail":"components:schemas:PublicCHLogV2DetailRequest:properties:completion_messages","oasType":"schema","type":"unknown","description":"Any type"}
inputstring
outputstring
{"stackTrail":"components:schemas:PublicCHLogV2DetailRequest:properties:variables","oasType":"schema","type":"unknown","description":"Any type"}
temperaturenumber double
max_tokensinteger
top_pnumber double
frequency_penaltynumber double
presence_penaltynumber double
stopstring
{"stackTrail":"components:schemas:PublicCHLogV2DetailRequest:properties:response_format","oasType":"schema","type":"unknown","description":"Any type"}
unit_pricesobject
component_costsobject
custom_identifierstring
group_identifierstring
blurredboolean
start_timestring date-time
timestampstring date-time
load_balance_group_idstring
prompt_tokensinteger
completion_tokensinteger
prompt_cache_hit_tokensinteger
prompt_cache_creation_tokensinteger
reasoning_tokensinteger
total_request_tokensinteger
costnumber double
llm_gateway_markup_ratenumber double
service_tierstring
model_discountnumber double
pricing_tierstring
audio_input_filestring
audio_output_filestring
organization_key_idstring
user_emailstring
modelstring
provider_idstring
categorystring
propertiesstring
cache_bitinteger
cache_miss_bitinteger
cache_keystring
latencynumber double
tokens_per_secondnumber double
time_to_first_tokennumber double
routing_timenumber double
statusstring
has_tool_callsboolean
status_codeinteger
log_methodstring
log_typestring
environmentstring
streamboolean
evaluation_identifierstring
customer_identifierstring
customer_emailstring
customer_namestring
customer_user_unique_idstring
used_custom_credentialboolean
deployment_namestring
deployment_idstring
prompt_namestring
prompt_idstring
prompt_version_numberinteger
system_textstring
prompt_textstring
completion_textstring
prompt_message_countinteger
completion_message_countinteger
trace_unique_idstring
span_unique_idstring
span_namestring
span_parent_idstring
span_workflow_namestring
session_identifierstring
span_linksstring
trace_group_identifierstring
thread_identifierstring
thread_unique_idstring
storage_object_keystring
period_startstring date-time
period_endstring date-time
unique_idstring
respan_gateway_request_idstring
full_textstring
Response
idstring required
organization_key_namestring required
organization_idstring
unique_organization_idstring
error_messagestring
warningsstring required
status_in_eval_setstring required
full_requeststring required
full_responsestring required
metadatastring required
scoresstring required
toolsstring required
tool_callsstring required
prompt_messagesstring required
completion_messagestring required
{"stackTrail":"components:schemas:PublicCHLogV2Detail:properties:completion_messages","oasType":"schema","type":"unknown","description":"Any type"}
inputstring
outputstring
{"stackTrail":"components:schemas:PublicCHLogV2Detail:properties:variables","oasType":"schema","type":"unknown","description":"Any type"}
temperaturenumber double
max_tokensinteger
top_pnumber double
frequency_penaltynumber double
presence_penaltynumber double
stopstring
{"stackTrail":"components:schemas:PublicCHLogV2Detail:properties:response_format","oasType":"schema","type":"unknown","description":"Any type"}
unit_pricesobject
component_costsobject
custom_identifierstring
group_identifierstring
blurredboolean
start_timestring date-time
timestampstring date-time
load_balance_group_idstring
prompt_tokensinteger
completion_tokensinteger
prompt_cache_hit_tokensinteger
prompt_cache_creation_tokensinteger
reasoning_tokensinteger
total_request_tokensinteger
costnumber double
llm_gateway_markup_ratenumber double
service_tierstring
model_discountnumber double
pricing_tierstring
audio_input_filestring
audio_output_filestring
organization_key_idstring
user_emailstring
modelstring
provider_idstring
categorystring
propertiesstring
cache_bitinteger
cache_miss_bitinteger
cache_keystring
latencynumber double
tokens_per_secondnumber double
time_to_first_tokennumber double
routing_timenumber double
statusstring
has_tool_callsboolean
status_codeinteger
log_methodstring
log_typestring
environmentstring
streamboolean
evaluation_identifierstring
customer_identifierstring
customer_emailstring
customer_namestring
customer_user_unique_idstring
used_custom_credentialboolean
deployment_namestring
deployment_idstring
prompt_namestring
prompt_idstring
prompt_version_numberinteger
system_textstring
prompt_textstring
completion_textstring
prompt_message_countinteger
completion_message_countinteger
trace_unique_idstring
span_unique_idstring
span_namestring
span_parent_idstring
span_workflow_namestring
session_identifierstring
span_linksstring
trace_group_identifierstring
thread_identifierstring
thread_unique_idstring
storage_object_keystring
period_startstring date-time
period_endstring date-time
unique_idstring
respan_gateway_request_idstring
full_textstring