List Calls - Cekura

cURL

curl --request GET \
  --url https://api.cekura.ai/observability/v1/call-logs/ \
  --header 'X-CEKURA-API-KEY: <api-key>'

{
  "count": 123,
  "next": "https://api.cekura.ai/example/v1/example-external/?page=4",
  "previous": "https://api.cekura.ai/example/v1/example-external/?page=3",
  "results": [
    {
      "id": 123,
      "duration": "<string>",
      "success": true,
      "is_reviewed": true,
      "status": "success",
      "feedback": "<string>",
      "metrics": [
        {
          "id": 123,
          "name": "<string>",
          "type": "<string>",
          "score": 123,
          "enum": "<string>",
          "value": "<string>"
        }
      ],
      "call_ended_reason": "<string>",
      "customer_number": "<string>",
      "agent": 123,
      "call_id": "<string>",
      "timestamp": "2023-11-07T05:31:56Z",
      "error_message": "<string>",
      "dropoff_point": "<string>",
      "topic": "<string>",
      "created_at": "2023-11-07T05:31:56Z",
      "updated_at": "2023-11-07T05:31:56Z"
    }
  ]
}

GET

observability

call-logs

cURL

curl --request GET \
  --url https://api.cekura.ai/observability/v1/call-logs/ \
  --header 'X-CEKURA-API-KEY: <api-key>'

{
  "count": 123,
  "next": "https://api.cekura.ai/example/v1/example-external/?page=4",
  "previous": "https://api.cekura.ai/example/v1/example-external/?page=3",
  "results": [
    {
      "id": 123,
      "duration": "<string>",
      "success": true,
      "is_reviewed": true,
      "status": "success",
      "feedback": "<string>",
      "metrics": [
        {
          "id": 123,
          "name": "<string>",
          "type": "<string>",
          "score": 123,
          "enum": "<string>",
          "value": "<string>"
        }
      ],
      "call_ended_reason": "<string>",
      "customer_number": "<string>",
      "agent": 123,
      "call_id": "<string>",
      "timestamp": "2023-11-07T05:31:56Z",
      "error_message": "<string>",
      "dropoff_point": "<string>",
      "topic": "<string>",
      "created_at": "2023-11-07T05:31:56Z",
      "updated_at": "2023-11-07T05:31:56Z"
    }
  ]
}

Authorizations

X-CEKURA-API-KEY

string

header

required

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

Query Parameters

page

integer

A page number within the paginated result set.

page_size

integer

Number of results to return per page.

timestamp_from

string<date-time>

Filter results from this timestamp (e.g. 2025-01-01T00:00:00Z) Example: 2025-01-01T00:00:00Z

timestamp_to

string<date-time>

Filter results to this timestamp (e.g. 2025-01-31T23:59:59Z) Example: 2025-01-31T23:59:59Z

call_ids

string

Comma-separated list of call log IDs Example: 1,2,3

Minimum string length: 1

agent_id

integer

required

Filter by agent ID Example: 2142

assistant_id

string

Filter by assistant ID Example:

"asst_1234567890"
"agent_xyz789"

Minimum string length: 1

Response

200 - application/json

count

integer

Example:

123

string<uri> | null

Example:

"https://api.cekura.ai/example/v1/example-external/?page=4"

string<uri> | null

Example:

"https://api.cekura.ai/example/v1/example-external/?page=3"

results

object[]

Show child attributes

results.id

integer

results.duration

string

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

results.success

boolean | null

Whether the call was successful. Example: true or false

results.is_reviewed

boolean

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

results.status

enum<string>

Status of the call or conversation. Example: "completed" or "failed"

success - Success
failure - Failure
reviewed_success - Reviewed Success
reviewed_failure - Reviewed Failure

Available options:

success,

failure,

reviewed_success,

reviewed_failure

results.feedback

string

Feedback about the call. Example: "Great Call"

results.metrics

object[]

Metrics of the call

Show child attributes

results.metrics.id

integer

Metric ID

results.metrics.name

string

Metric name

results.metrics.type

string

Metric type

results.metrics.score

number<double>

Evaluated metric score, Present if metrictype is not enum

results.metrics.enum

string

Metric enum, Present if type is enum

results.metrics.value

string

Evaluated metric value, Present if metric type is enum

results.call_ended_reason

string

Reason why the call ended. Example:

"customer-ended-call"
"agent-ended-call"

Maximum string length: 100

results.customer_number

string

Customer's phone number or identifier. Example:

"+1234567890"
"customer_abc123"

Maximum string length: 100

results.agent

integer | null

Agent ID

results.call_id

string

Unique identifier for the call. Example:

"call_abc123xyz"
"stereo_audio_session_456"

Maximum string length: 100

results.timestamp

string<date-time>

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

results.error_message

string | null

results.dropoff_point

string

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

Maximum string length: 1000

results.topic

string

Topic of the call. Example:

"product_inquiry"
"technical_support"

Maximum string length: 1000

results.created_at

string<date-time>

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

results.updated_at

string<date-time>

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

Get Call Reevaluate Calls

⌘I

API Reference

Authorizations

Query Parameters

Response