List Results - Cekura

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.

agent_id

integer

required

Filter by agent ID

string

Filter by Result name

scenarios

string

Filter by scenarios (comma-separated list of scenario IDs)

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

Unique identifier for the Result Example: 123

results.name

string

Name of the Result Example: "Test Result 1"

Maximum string length: 255

results.agent

integer

ID of the AI agent that was tested Example: 123

results.status

enum<string>

default:pending

Current status of the result

running - Running
completed - Completed
failed - Failed
pending - Pending
in_progress - In Progress
evaluating - Evaluating
in_queue - In Queue
timeout - Timeout
cancelled - Cancelled

Available options:

running,

completed,

failed,

pending,

in_progress,

evaluating,

in_queue,

timeout,

cancelled

results.success_rate

number<double>

default:0

Success rate of the test runs as a decimal (0.0 to 1.0)

results.run_as_text

boolean

default:false

Whether this test was run in text mode instead of voice mode Example: true or false

results.is_cronjob

string

Whether this result was created by a scheduled cronjob Example: true or false

results.runs

object

List of test runs associated with this result, including run details, status, scenario information, and phone numbers used Example:

{
    "run_id": {
      "id": "integer",
      "scenario": "integer",
      "outbound_number": "string",
      "expected_outcome": {
        "score": 100,
        "explanation": [
          "✅ Positive outcome explanation with checkmark emoji",
          "❌ Negative outcome explanation with X emoji"
        ],
        "outcome_alignments": [
          {
            "outcome": "string",
            "prompt_part": "string",
            "aligned": "boolean"
          }
        ]
      },
      "success": "boolean",
      "evaluation": {
        "metrics": [
          {
            "id": "integer",
            "name": "string",
            "type": "binary_workflow_adherence | binary_qualitative | continuous_qualitative | numeric | enum",
            "score": "number",
            "explanation": "string | array",
            "function_name": "string (optional)",
            "extra": {
              "categories": [
                {
                  "category": "string",
                  "deviation": "string (optional)",
                  "priority": "string (optional)"
                }
              ],
              "percentiles": {
                "p50": "number"
              }
            },
            "enum": "string (for enum type metrics only)"
          }
        ]
      },
      "timestamp": "datetime",
      "executed_at": "datetime",
      "error_message": "string",
      "status": "string",
      "duration": "string (MM:SS format)",
      "scenario_name": "string",
      "personality_name": "string",
      "metadata": "object",
      "inbound_number": "string"
    }
}

Show child attributes

results.runs.{key}

any

results.met_expected_outcome_count

string

Number of test runs that met the expected outcome criteria Example: 10

results.total_expected_outcome_count

string

Total number of test runs that were evaluated for expected outcomes Example: 10

results.total_runs_count

string

Total number of test runs associated with this result Example: 10

results.completed_runs_count

string

Number of test runs that have completed successfully Example: 10

results.success_runs_count

string

Number of test runs that were marked as successful Example: 10

results.failed_runs_count

string

Number of test runs that failed or encountered errors Example: 10

results.scenarios

object

List of scenario names used in the test runs for this result Example:

[
    {
        "id": 123,
        "name": "Scenario 1"
    },
    {
        "id": 456,
        "name": "Scenario 2"
    }
]

Show child attributes

results.scenarios.{key}

any

results.created_at

string<date-time>

Timestamp when this test result was created Example: 2021-01-01 00:00:00

results.updated_at

string<date-time>

Timestamp when this test result was last updated

API Reference

Authorizations

Query Parameters

Response