API Reference Get Latest Lint Run
Get Latest Lint Run
The newest completed project-wide lint run, with its finding counts.
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
projectIdThe project ID.
Response Fields
NameDescription
buildShaThe commit the pages were read at — the head of the project's branch when the run started.
pagesCheckedPages that were read and linted.
pagesSkippedPages 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 · infoFinding 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
Previous
Next
Request
cURLJavaScriptPythonGoRubyPHPJavaC#cURL
curl https://api.syntext.dev/v1/projects/3f2a9c1e-8b4d-4e7a-9c21-5d6e7f8a9b0c/lint-runs/latest \
-H "Authorization: Bearer eyJhbGciOiJIUzI1NiIs..."
const response = await fetch('https://api.syntext.dev/v1/projects/3f2a9c1e-8b4d-4e7a-9c21-5d6e7f8a9b0c/lint-runs/latest', {
method: 'GET',
headers: {
'Authorization': 'Bearer eyJhbGciOiJIUzI1NiIs...',
},
});
const data = await response.json();
console.log(response.status, data);
import requests
url = "https://api.syntext.dev/v1/projects/3f2a9c1e-8b4d-4e7a-9c21-5d6e7f8a9b0c/lint-runs/latest"
headers = {
"Authorization": "Bearer eyJhbGciOiJIUzI1NiIs...",
}
response = requests.get(url, headers=headers)
print(response.status_code)
print(response.json())
package main
import (
"fmt"
"io"
"net/http"
)
func main() {
req, err := http.NewRequest("GET", "https://api.syntext.dev/v1/projects/3f2a9c1e-8b4d-4e7a-9c21-5d6e7f8a9b0c/lint-runs/latest", nil)
if err != nil {
panic(err)
}
req.Header.Set("Authorization", "Bearer eyJhbGciOiJIUzI1NiIs...")
res, err := http.DefaultClient.Do(req)
if err != nil {
panic(err)
}
defer res.Body.Close()
body, err := io.ReadAll(res.Body)
if err != nil {
panic(err)
}
fmt.Println(res.Status)
fmt.Println(string(body))
}
require "net/http"
require "uri"
uri = URI("https://api.syntext.dev/v1/projects/3f2a9c1e-8b4d-4e7a-9c21-5d6e7f8a9b0c/lint-runs/latest")
http = Net::HTTP.new(uri.host, uri.port)
http.use_ssl = uri.scheme == "https"
request = Net::HTTP::Get.new(uri)
request["Authorization"] = "Bearer eyJhbGciOiJIUzI1NiIs..."
response = http.request(request)
puts response.code
puts response.body
<?php
$ch = curl_init();
curl_setopt_array($ch, [
CURLOPT_URL => 'https://api.syntext.dev/v1/projects/3f2a9c1e-8b4d-4e7a-9c21-5d6e7f8a9b0c/lint-runs/latest',
CURLOPT_CUSTOMREQUEST => 'GET',
CURLOPT_RETURNTRANSFER => true,
CURLOPT_HTTPHEADER => [
'Authorization: Bearer eyJhbGciOiJIUzI1NiIs...',
],
]);
$response = curl_exec($ch);
if ($response === false) {
throw new RuntimeException(curl_error($ch));
}
$status = curl_getinfo($ch, CURLINFO_RESPONSE_CODE);
curl_close($ch);
echo $status, PHP_EOL, $response, PHP_EOL;
import java.net.URI;
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;
public class Main {
public static void main(String[] args) throws Exception {
HttpRequest request = HttpRequest.newBuilder()
.uri(URI.create("https://api.syntext.dev/v1/projects/3f2a9c1e-8b4d-4e7a-9c21-5d6e7f8a9b0c/lint-runs/latest"))
.header("Authorization", "Bearer eyJhbGciOiJIUzI1NiIs...")
.GET()
.build();
HttpResponse<String> response = HttpClient.newHttpClient()
.send(request, HttpResponse.BodyHandlers.ofString());
System.out.println(response.statusCode());
System.out.println(response.body());
}
}
using System.Net.Http;
using System.Text;
using var client = new HttpClient();
using var request = new HttpRequestMessage(HttpMethod.Get, "https://api.syntext.dev/v1/projects/3f2a9c1e-8b4d-4e7a-9c21-5d6e7f8a9b0c/lint-runs/latest");
request.Headers.TryAddWithoutValidation("Authorization", "Bearer eyJhbGciOiJIUzI1NiIs...");
using var response = await client.SendAsync(request);
Console.WriteLine((int)response.StatusCode);
Console.WriteLine(await response.Content.ReadAsStringAsync());
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
}
}