Skip to main content
GET
Preview. This endpoint is available to organisations in the Wordsmith MCP pilot. Other organisations receive 403 mcp_not_enabled. See the preview overview.
Returns a page of the reports you can read, most recently updated first. A report is a grid with one row per document and one AI-answered column per question. Filter by repository_id to find the reports whose rows follow one repository. Reports on the legacy report engine are not listed, and cannot be read through the API.

Authentication

Requires an API key, or an OAuth token with reports:read.

Query parameters

string
Only reports whose rows follow this repository.
string
Only reports whose name contains this text. The match ignores case.
string
The cursor from the previous page. Leave it out for the first page.
integer
default:"50"
Reports per page, from 1 to 200. Keep it, and the filters, the same for every page of a walk.

Response

Returns 200 with a page of reports. cursor is null on the last page. Read one with Get Report to see its columns.

Errors