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 \
     --data-urlencode cursor=2026-09-14T15:02:05.000Z \
     -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": "twilio",
        "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": "2026-09-14T15:02:05.000Z"
  }
}

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. 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 the created_at of the last row and pages with a strict “created before” comparison.
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: Outbound — 20 requests/min per workspace, shared by every /api/calls endpoint including reads. See Rate limits.
Plan: Available on every plan.

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`. `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 the `created_at` of the last row and pages with a strict "created before" comparison. - **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:** Outbound — 20 requests/min per workspace, shared by every `/api/calls` endpoint including reads. See [Rate limits](/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.

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](/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).

cursordatetimeOptional

The nextCursor of the previous page (an ISO-8601 created_at timestamp). Returns calls created strictly before it. The value is not validated, so pass back exactly what you received. Ignored 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

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

Cursor: pass the previous page’s nextCursor as cursor. 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 the created_at of the last row and pages with a strict “created before” comparison.
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.

Idempotency. Read-only; safe to retry.

Access

Required scope: read (or write).
Rate limit: Outbound — 20 requests/min per workspace, shared by every /api/calls endpoint including reads. See Rate limits.
Plan: Available on every plan.