CEcekura
observability

Get a call log

Changed on

Retrieve a production CallLog by its integer CallLog ID (path parameter). This is distinct from simulation run_id (use runs_retrieve for those) and from the call log's own call_id string field (the provider's call identifier).

get/observability/v2/call-logs/{id}/

Request

  • Base URL
    https://api.cekura.ai
  • URL
    https://api.cekura.ai/observability/v2/call-logs/{id}/
  • Auth
    • API key in header X-CEKURA-API-KEY
    • or HTTP bearer
    • or HTTP bearer
    • or HTTP bearer

Path parameters

idinteger required

A unique integer value identifying this call log.

Response

idinteger
durationstring

Call duration in minutes in MM:SS format. Example: 01:10

voice_recording_urlstring

URL to access the voice recording. Example: "https://storage.example.com/recordings/call_123_20240315.mp3"

status'success' | 'failure' | 'reviewed_success' | 'reviewed_failure'
  • success - Success
  • failure - Failure
  • reviewed_success - Reviewed Success
  • reviewed_failure - Reviewed Failure
agent_idstring

Agent ID. Example: 2142

agent_namestring

Agent name

agent_versionobject nullable

The agent version (history record) that was live when this call was ingested, or null.

metadataobject

Additional call metadata. Example:

{
    "ended_reason": "customer-ended-call",
    "ringing_duration": 3.941,
    "call_type": "inbound"
}
dynamic_variablesobject

Dynamic Variables used in the call. Example:

{
    "customer_name": "John Doe",
    "order_id": "ORD-12345",
    "product_type": "premium"
}
testing_channel_indexinteger nullable

The channel index of the testing agent in the audio recording

waveformobject

Amplitude envelope of the recording, one array of values per audio channel, so a waveform can be drawn without downloading the audio. Null for recordings processed before peaks were stored.

timestampstring date-time

When the call occurred. Example: 2024-03-15T10:15:45Z

successboolean nullable

Whether the call was successful. Example: true or false

is_reviewedboolean

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

feedbackstring

Feedback about the call. Example: "Great Call"

rubricunknown
transcriptstring

Full text transcript of the call. Example:

[00:01] Testing Agent: Hello. 
[00:02] Main Agent: Hello, how can I help you today?
[00:03] Testing Agent: Well, I mean, sure. What time exactly are we talking about here
[00:04] Main Agent: 6 PM.
[00:05] Testing Agent: Great. I'll book that for you. Just a sec.
[00:06] Main Agent: Okay.
call_ended_reasonstring

Reason why the call ended. Example:

  • "customer-ended-call"
  • "agent-ended-call"
dropoff_pointstring

Point in conversation where user disengaged. Example: "end of conversation as no queries remaining"

topicstring

Topic of the call. Example:

  • "product_inquiry"
  • "technical_support"
customer_numberstring

Customer's phone number or identifier. Example:

  • "+1234567890"
  • "customer_abc123"
user_generated_transcriptunknown
error_messagestring nullable
created_atstring date-time

When this record was created. Example: 2024-03-15T10:30:45Z

updated_atstring date-time

When this record was last updated. Example: 2024-03-15T10:35:11Z

call_idstring required

Unique identifier for the call. Example:

  • "call_abc123xyz"
  • "stereo_audio_session_456"
trace_idstring

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

is_log_presentboolean

Whether provider execution logs are stored for this call.

agentinteger nullable

Agent ID

projectinteger nullable

Project ID (denormalized from agent for query performance)

Changes