Jelliu API documentation

curl -G https://api.jelliu.co/api/calls \
     -H "Authorization: Bearer <token>" \
     -d agentId=2f2d8b4d-aa6f-41e0-9d3e-4d61e1b07a11 \
     -d campaignId=fbb7c4c9-0e1d-4f58-a3d7-6c3a99b8d7c0 \
     -d cursor=MjAyNi0wOS0xNFQxNTowMjowNS4wMDAwMDBafDhkMGYzYzFlLTViN2EtNGM1Mi05ZDBlLTJhNmYxYjNjNGQ1ZQ \
     -d limit=25 \
     -d offset=50

{
  "data": {
    "calls": [
      {
        "id": "8d0f3c1e-5b7a-4c52-9d0e-2a6f1b3c4d5e",
        "tenant_id": "5a1b2c3d-4e5f-4a6b-8c7d-9e0f1a2b3c4d",
        "phone_number": "+573001234567",
        "status": "completed",
        "call_direction": "outbound",
        "created_at": "2026-09-14T15:02:05.000Z",
        "updated_at": "2026-09-14T15:04:40.000Z",
        "campaign_id": null,
        "contact_id": "c3a1f2e4-7b6d-4e5f-9a8b-0c1d2e3f4a5b",
        "agent_id": "2f2d8b4d-aa6f-41e0-9d3e-4d61e1b07a11",
        "outcome": "appointment_booked",
        "duration_seconds": 142,
        "prompt_variant_id": null,
        "summary": "La clienta agendó una cita de valoración para el martes a las 10:00.",
        "sentiment_score": 1,
        "frustration_score": 0.05,
        "sentiment_low": 0,
        "objections": [],
        "evaluation_criteria_results": {
          "cita_agendada": {
            "result": "success",
            "rationale": "La clienta aceptó el martes a las 10:00."
          }
        },
        "data_collection_results": {
          "fecha_cita": {
            "value": "2026-09-16T10:00:00-05:00",
            "rationale": "Confirmó el martes a las 10."
          }
        },
        "analysis": {
          "summary": "La clienta agendó una cita de valoración para el martes a las 10:00.",
          "outcome": "appointment_booked",
          "sentiment": "positive",
          "sentiment_score": 1,
          "key_topics": [],
          "qualification": null
        },
        "has_recording": true,
        "agent_name": "Sofía - Agendamiento",
        "campaign_name": null,
        "contact_name": "Laura Gómez",
        "cost_credits": 1420,
        "cost_usd": "0.3012",
        "termination_reason": "end_call tool was called.",
        "main_language": "es",
        "initiation_source": "phone",
        "call_success_score": 92,
        "agent_talk_seconds": 71.4,
        "user_talk_seconds": 48.2,
        "agent_turn_count": 11,
        "user_turn_count": 10,
        "interruption_count": 1,
        "avg_response_latency_ms": 910,
        "max_response_latency_ms": 1840,
        "started_at": "2026-09-14T15:02:11.000Z",
        "ended_at": "2026-09-14T15:04:33.000Z",
        "deleted_at": null
      }
    ],
    "total": 132,
    "limit": 25,
    "offset": 0,
    "nextCursor": "MjAyNi0wOS0xNFQxNTowMjowNS4wMDAwMDBafDhkMGYzYzFlLTViN2EtNGM1Mi05ZDBlLTJhNmYxYjNjNGQ1ZQ"
  }
}

Returns the workspace’s calls, inbound and outbound, newest first (created_at descending), optionally filtered by agent and/or campaign. Use GET /api/calls/{callId} for the transcript and the detail-only columns.

Two pagination styles are supported; use one or the other:

Cursor: pass the previous page’s nextCursor as cursor, unchanged. nextCursor is non-null whenever the page came back full (exactly limit rows), so the last page can be followed by one empty page. The cursor is opaque: it encodes the position of the last row (its created_at and id), so calls created at the same instant are never skipped or repeated between pages. Order ties on created_at are broken by id, descending. A legacy cursor (a bare ISO-8601 timestamp, the format used until 2026-09-15) is still accepted and returns calls created strictly before it.
Offset: pass offset for a numbered pager. When offset is greater than 0 it takes precedence and cursor is ignored. total is always the count of every call matching the filters.

List rows omit the large or detail-only columns (transcript, transfer_*, kpi_data, token counts, sentiment_timeline, execution counters and a few more); see the Call schema for the exact list. Vendor identifiers (carrier call SID, voice-provider conversation id) are never returned.

Consistency. Pages are cached for up to 60 seconds per exact combination of parameters. A manual hang-up invalidates the cache; post-call updates may take up to a minute to appear here, while GET /api/calls/{callId} is invalidated on the same events.

Idempotency. Read-only; safe to retry.

Access

Required scope: read (or write).
Rate limit: General API — 120 (Starter), 200 (Growth), 300 (Business) or 600 (Enterprise) requests/min per workspace. The 20/min outbound limit does not apply to this route. See Rate limits.
Plan: Available on every plan.

Authentication

AuthorizationBearer

Workspace API key: jl_ followed by 64 lowercase hex characters, created by the workspace owner in the dashboard (Settings → API Keys) and sent as Authorization: Bearer jl_.... The plaintext is shown once, at creation; Jelliu stores only a SHA-256 hash. A workspace can hold up to 25 active keys.

Scope	GET / HEAD	POST / PUT / PATCH / DELETE	Admin-only routes
`read`	Yes	No	No
`write`	Yes	Yes	No
`full`	Yes	Yes	Yes

Operations restricted to admins or owners reject keys without the full scope with 403, and say so in their description. No key, whatever its scope, can mint or revoke API keys or rotate a webhook secret — that requires a signed-in owner session. A revoked key stops authenticating within about 10 seconds. See Authentication.

Query parameters

limitintegerOptional1-100Defaults to 50

Page size, 1 to 100. A value outside the range or not an integer is rejected with 400 (it is not clamped).

cursorstringOptional<=512 characters

The opaque nextCursor of the previous page; pass it back exactly as received. Returns the calls that follow that position. A legacy ISO-8601 timestamp is still accepted and returns calls created strictly before it. Any other value is rejected with 400 VALIDATION_FAILED. Ignored (and not validated) when offset is greater than 0.

offsetintegerOptional0-100000Defaults to 0

Rows to skip for numbered pagination, 0 to 100000 (400 outside the range). Takes precedence over cursor when greater than 0.

agentIdstringOptionalformat: "uuid"

Only calls served by this agent. Must be a UUID (400 otherwise). An agent of another workspace simply matches nothing.

campaignIdstringOptionalformat: "uuid"

Only calls filed under this campaign. Must be a UUID (400 otherwise).

Response

One page of calls.

dataobject

Errors

400

Bad Request Error

401

Unauthorized Error

403

Forbidden Error

429

Too Many Requests Error