Crosscheck
Open app
API Reference Checks

List Checks

GEThttps://api-v2.crosscheck.cloud/api/v1/checks

Retrieve a paginated list of checks visible to the current user. Filter by project or search text, and choose the sort order.

Authentication

Send a valid Crosscheck session JWT in the Authorization: Bearer YOUR_SESSION_TOKEN header. Workspace endpoints use the active workspace in your session. MCP OAuth tokens are not accepted here.

Query Parameters

Only return checks in this project UUID.

Page number. Defaults to 1.

Results per page, from 1 to 100. Defaults to 20.

Search checks by text.

Defaults to all.

Sort direction. Defaults to desc.

Sort field. Defaults to createdAt.

Optional recordingLinkId filter. Must be a UUID.

Optional tagId filter.

Optional type filter.

Optional statusId filter.

Optional feature filter.

Optional severity filter.

Optional dateStart filter.

Optional dateEnd filter.

Filter by status state: open or closed.

Headers

Accept

JSON request and response format.

application/json
Authorization

A valid session JWT from Crosscheck authentication.

Bearer YOUR_SESSION_TOKEN

Responses

200 OK
dataarrayChecks with tags, project, counts, tasks and retention information.
totalintegerTotal matching checks.
allChecksCount / sharedWithMeCountintegerCounts for each view.
page / limitintegerCurrent page and page size.
400 Invalid request

The API returns success, error, code and statusCode. Validation errors also include details. Select this status in the example panel to inspect the shape.

401 Authentication required

The API returns success, error, code and statusCode. Validation errors also include details. Select this status in the example panel to inspect the shape.

403 Insufficient permissions

The API returns success, error, code and statusCode. Validation errors also include details. Select this status in the example panel to inspect the shape.

404 Resource not found

The API returns success, error, code and statusCode. Validation errors also include details. Select this status in the example panel to inspect the shape.

Selected fields and abbreviated examples are shown. Additional fields and error codes depend on the resource, permissions, plan and retention state.