/Docs
Search docs or ask a question⌘K
DocsAgent
Changelog
API Reference Get Latest Lint Run

Get Latest Lint Run

The newest completed project-wide lint run, with its finding counts.

GET/v1/projects/{projectId}/lint-runs/latestTry it
Session token

Returns the newest completed project-wide lint run — started with Run Project Lint — with how many pages it checked and how many findings it made at each severity. The findings themselves are in GET /lint-results.

Note

Any member of the workspace can call this, signed in with a session JWT — API keys are refused with 401. You must belong to the organization that owns {projectId}. Available on every plan.

Path Parameters

NameDescription
projectId:stringpathRequired
The project ID.

Response Fields

NameDescription
buildSha:string | null
The commit the pages were read at — the head of the project's branch when the run started.
pagesChecked:integer
Pages that were read and linted.
pagesSkipped:integer
Pages that were not linted: those matching the linter's ignoredPaths, those over the 500-page cap, and any that could not be read.
errors · warnings · info:integer
Finding counts by severity. info counts findings with severity suggestion.

Error Responses

401 Unauthorized

No session JWT, an expired one, or an API key.

403 Forbidden

forbidden — you are not a member of the organization that owns the project.

404 Not Found

not_found — the project has no completed run yet, or the project does not exist. For a project with no run:

json
{
"error": {
"code": "not_found",
"message": "No lint run yet",
"details": { "traceId": "6f1c2a9e-3b7d-4c11-9a0e-2d5f8b4c7e10" }
}
}
Was this page helpful? Yes No
Request
cURLJavaScriptPythonGoRubyPHPJavaC#cURL
curl https://api.syntext.dev/v1/projects/3f2a9c1e-8b4d-4e7a-9c21-5d6e7f8a9b0c/lint-runs/latest \
-H "Authorization: Bearer eyJhbGciOiJIUzI1NiIs..."
Responseapplication/json
200OK
{
"data": {
"id": "e4a1c9b2-7d3f-4b6e-8a1c-2f9d0b3e4c5a",
"status": "completed",
"buildSha": "a3f9c21b7e04d5f6a7b8c9d0e1f2a3b4c5d6e7f8",
"pagesChecked": 142,
"pagesSkipped": 3,
"durationMs": 4200,
"createdAt": "2026-11-08T09:00:00.000Z",
"completedAt": "2026-11-08T09:00:04.200Z",
"errors": 3,
"warnings": 12,
"info": 5
}
}
Product
Resources
Company
© 2026 SyntextBuilt with Syntext