List all cases
Cases
List Cases
Retrieve a list of cases belonging to the authenticated user, with optional exact-match label lookup.
GET
List all cases
Retrieve a list of cases belonging to the authenticated user. Cases are returned in reverse chronological order (newest first).
A typical integration uses this to check whether a case already exists for an external reference before creating a new one, making the create-or-fetch flow safely idempotent.
Finding a case by label
Pass the optionallabel query parameter to fetch the case (or cases) whose label matches exactly. The match is case-sensitive and applies to the same access scope as the unfiltered list: you see only your own cases unless your organisation has shared cases enabled, in which case you see any matching case in the organisation.
Best Practices
- Use List for Overview: Use
GET /casesfor dashboards and case selection. - Use Details for Specifics: Use
GET /cases/{id}when you need file-level information. - Use Label Lookup for Idempotency: Use
GET /cases?label=...when you have an external reference (claim number, policy ID) and want to find or create a case by that identifier without paginating. - Use Search for Discovery: For partial or fuzzy matching across case labels and file names, use
GET /searchinstead.?label=on this endpoint is exact-match only. - Monitor Status: Check
file_analysis_statusfor processing updates.
Authorizations
Query Parameters
Maximum number of cases to return
Required range:
1 <= x <= 100Number of cases to skip for pagination
Required range:
0 <= x <= 9007199254740991Required string length:
1 - 255