Your API key:

All requests below will use this key. Your API key is sent directly to api.cueapi.ai and never stored by the docs site.

GET/v1/executions

List Executions

List executions with optional filters for status, outcome, evidence, and more.

cue_idstringquery

Filter by cue ID.

statusstringquery

Filter by execution status: pending, delivering, success, failed, retrying, missed, pending_outcome, outcome_timeout.

outcome_statestringquery

Filter by outcome state: reported_success, reported_failure, verified_success, verification_pending, verification_failed, unknown.

result_typestringquery

Filter by evidence result type (e.g., tweet, email, stripe_charge).

has_evidencebooleanquery

Filter to executions with evidence (true) or without (false).

triggered_bystringquery

Filter by trigger source: schedule, manual_fire, replay.

limitintegerdefault: 20query

Results per page (1-100).

offsetintegerdefault: 0query

Pagination offset.

Request

bash

curl https://api.cueapi.ai/v1/executions?limit=10 \
  -H "Authorization: Bearer YOUR_API_KEY"

bash

curl "https://api.cueapi.ai/v1/executions?cue_id=cue_abc123&status=failed" \
  -H "Authorization: Bearer YOUR_API_KEY"

bash

curl "https://api.cueapi.ai/v1/executions?has_evidence=true&result_type=tweet" \
  -H "Authorization: Bearer YOUR_API_KEY"

Response

json

{
  "executions": [
    {
      "id": "550e8400-e29b-41d4-a716-446655440000",
      "cue_id": "cue_abc123",
      "scheduled_for": "2026-03-23T09:00:00Z",
      "status": "success",
      "outcome_state": "verified_success",
      "triggered_by": "schedule"
    }
  ],
  "total": 42,
  "limit": 10,
  "offset": 0,
  "has_more": true
}

Previous← Fire a Cue NextList Claimable →