Matters

List matters

Lists the cases and deals the caller can access, newest first. Admins see every matter; other users see the matters they own or are assigned to.

GET/api/v1/matters

Authorization

Authorizationstringheaderrequired

Bearer authentication header of the form Bearer <token>, where <token> is your Sentinel API key. See Authentication.

limitintegerquerydefault: 201–100

Matters per page.

cursorstringquery

The next_cursor from the previous page.

include_closedbooleanquerydefault: false

Include closed or archived cases and closed or terminated deals.

200 · A page of matters.

dataMatter[]required

Fields

idstringrequired

Matter ID.

typestringrequired

One of case deal

numberstringrequired

Case or deal number, e.g. CASE-2025-0142.

titlestringrequired

statusstring | nullrequired

Case or deal status, as set in Sentinel.

prioritystring | nullrequired

sub_typestring | nullrequired

Case violation type or deal type.

closedbooleanrequired

A closed or archived case, or a closed or terminated deal.

archived_atstring (date-time) | nullrequired

When a case was archived. Always null for deals.

created_atstring (date-time)required

paginationPaginationrequired

Fields

limitintegerrequired

has_morebooleanrequired

next_cursorstring | nullrequired

Pass as cursor to get the next page. Null on the last page.

Status	Type	When
`400`	`invalid_request`	Invalid parameters.
`401`	`authentication_required`	Missing, invalid, revoked or expired API key.
`403`	`permission_denied`	The key's role can't use the API.
`429`	`rate_limited`	More than 120 requests in a minute from one key. Retry after the `Retry-After` header's seconds.