Skip to main content
GET
cURL

Authorizations

X-CEKURA-API-KEY
string
header
required

API Key Authentication. It should be included in the header of each request.

Query Parameters

run_ids
string
required

Comma-separated list of run IDs. Example: 1,2,3

Must be a plain comma-separated string, not a JSON array — passing a JSON array returns a 400 error.

agent_id
integer

Tenant scope. Supply one of agent_id, result_id, project_id when authenticating with a user session or OAuth bearer token; omit when using an API key already scoped to the tenant.

result_id
integer

Tenant scope. Supply one of agent_id, result_id, project_id when authenticating with a user session or OAuth bearer token; omit when using an API key already scoped to the tenant.

project_id
integer

Tenant scope. Supply one of agent_id, result_id, project_id when authenticating with a user session or OAuth bearer token; omit when using an API key already scoped to the tenant.

Response

200 - application/json
id
integer
read-only
provider_call_id
string
read-only

Call ID from the Assistant provider Example: call_abc123

trace_id
string

OpenTelemetry trace ID (32-char hex). Set when OTel tracing is enabled.

Maximum string length: 32
scenario
integer | null
read-only
scenario_name
string
default:Scenario Deleted
read-only
scenario_type
string
read-only

Type of the run's scenario (e.g. instruction, conditional_actions), null if the scenario was deleted

personality
integer | null
read-only

Personality this run belongs to

personality_name
string
read-only

Name of the personality this run belongs to

agent
integer
read-only

ID of the agent associated with this run

agent_name
string
read-only

Name of the agent associated with this run

agent_version
object

The agent version (history record) this run's result ran against, or null.

result_id
integer
read-only
result_name
string
read-only

Name of the result this run belongs to

expected_outcome_prompt
string
read-only
expected_outcome
string
read-only
evaluation
object

Run Evaluation

rubric
any | null

Detailed rubric evaluation data Example:

transcript
string
read-only

Full text transcript of the call. Example:

transcript_object
object[]
read-only

Transcript object

duration
string
read-only

Duration of the run in MM:SS format

voice_recording_url
string
read-only

URL to access the voice recording of this run

email_id
string<email> | null
read-only
status
enum<string>
read-only
  • running - Running
  • completed - Completed
  • failed - Failed
  • pending - Pending
  • in_progress - In Progress
  • evaluating - Evaluating
  • in_queue - In Queue
  • timeout - Timeout
  • cancelled - Cancelled
  • scaling_up - Scaling Up
Available options:
running,
completed,
failed,
pending,
in_progress,
evaluating,
in_queue,
timeout,
cancelled,
scaling_up
evaluation_status
enum<string>
  • success - Success
  • failure - Failure
  • reviewed_success - Reviewed Success
  • reviewed_failure - Reviewed Failure
Available options:
success,
failure,
reviewed_success,
reviewed_failure
metadata
any
success
boolean

Whether this run passed its quality evaluation. false means either the call failed to connect or an evaluation check did not pass. Check error_message for connection failures and evaluation for check results.

is_reviewed
boolean

Whether the call has been reviewed. Example: true or false

feedback
string
timestamp
string<date-time>
read-only
executed_at
string<date-time> | null
read-only
outbound_number
string
read-only

Phone number used to make the outbound call for this run

inbound_number
string
read-only

Phone number used to receive the inbound call for this run

critical_categories
object[]
read-only

List of critical evaluation categories and their results for this run

error_message
string
scenario_instructions
string
run_as_text
boolean
read-only
test_profile_data
object | null

Test Profile

generated_mock_tool_entries
object[]
read-only

Expected mock tool calls for this run's evaluator. Each entry has shape {tool_id, tool_name, new_entry: {input, output}}.

mocked_tool_names
string[]
read-only

Tool names that were mock-enabled for this run's result. Function calls in the transcript matching these names were served by Cekura mocks. Empty if no tools were mocked.

provider_call_details
any
read-only

Details of the call from the provider

agent_number
string | null
read-only

Phone number of the agent (only for voice inbound calls)

testing_channel_index
integer | null
read-only

The channel index of the testing agent in the audio recording

run_type
string | null
read-only

Run Execution Type

outbound_dial_window_opens_at
string
read-only

ISO timestamp when the outbound dial window opened. Null until the run reaches pending/waiting-for-call.

outbound_dial_window_seconds
string
read-only

Duration of the outbound dial window in seconds.

outbound_dial_window_closes_at
string
read-only

ISO timestamp when the outbound dial window closes. Null until the window opens.