agentlyleads docs
Cases API

GET /api/v1/cases/{id}

Returns one case in the same shape the list endpoint uses. Requires the read:cases scope (or * for full access).

Request

GET /api/v1/cases/cmq2case0alk34567890 HTTP/1.1
Host: agentlyleads.com
Authorization: Bearer alk_live_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx

The path parameter is the agentlyleads case ID, as returned in cases[].id.

Response — 200

{
  "case": {
    "id": "cmq2case0alk34567890",
    "number": 31,
    "subject": "Pallet arrived damaged",
    "description": "Two of six bags split in transit.",
    "status": "OPEN",
    "severity": "HIGH",
    "source": "EMAIL",
    "open": true,
    "ageMins": 4320,
    "overdue": true,
    "company": { "id": "cmq2comp0alk34567890", "name": "Acme Corp" },
    "contact": { "id": "cmq2cont0alk34567891", "name": "Jane Buyer" },
    "assignee": { "id": "cmq9user0alk34567890", "name": "Kevin Rep" },
    "threadKey": "AAMkAGI2...",
    "firstResponseAt": "2026-09-04T08:12:00.000Z",
    "resolvedAt": null,
    "createdAt": "2026-09-04T07:55:00.000Z",
    "updatedAt": "2026-09-06T14:02:00.000Z"
  }
}

Response — 404

{ "error": "Case not found." }

The lookup is always fenced by workspace, so an ID that belongs to another workspace returns the same 404 as an ID that does not exist.

On this page