List errors

List errors. The project’s errors in a period - failures grouped by fingerprint - most frequent first: by occurrences, then runs, then tests, ties by fingerprint, so a page never changes order between two requests over the same data. Over the finished runs of the source (see population), all shards of a run one run. Every count covers the period; firstSeen is the first occurrence still stored, not bounded by it. Moderate: one aggregate query, paged in the database.

GET/api/v1/projects/{projectId}/errors

Parameters

Parameter	Description
`projectId`string · pathrequired	A project id from GET /projects.
`days`7 \| 14 \| 30 \| 90 · default 30	The period, in days, ending now. Must not exceed the plan’s retention (Standard 60, Pro 90 days); a longer period is refused with 400 invalid_period rather than answered with less data.
`source`ci \| local \| all · default all	Which runs count, by where they ran: all - every run (the default since 1.0.0-beta.18; ci before); ci - runs a shard reported a CI provider for; local - runs no shard did. The response’s population names the one counted.
`page`integer · default 1	1-based page number. A page past the end answers the last page.
`perPage`10 \| 25 \| 50 · default 10	Rows per page.

Request

BASE="https://app.squally.dev/api/v1"
URL="$BASE/projects/$PROJECT/errors"
curl "$URL" \
  -H "Authorization: Bearer $SQUALLY_API_KEY"

const base = "https://app.squally.dev/api/v1";
const key = process.env.SQUALLY_API_KEY;
const url = `${base}/projects/${projectId}`
  + `/errors`;
const response = await fetch(url, {
  headers: { Authorization: `Bearer ${key}` },
});
const data = await response.json();

import os
import requests

base = "https://app.squally.dev/api/v1"
key = os.environ["SQUALLY_API_KEY"]
url = f"{base}/projects/{project_id}/errors"
response = requests.get(
    url,
    headers={"Authorization": f"Bearer {key}"},
)
data = response.json()

{
  "project": {
    "id": "3f7c2a91-5b8e-4d0a-9c61-2e4b7f0d8a…",
    "name": "storefront-web"
  },
  "population": "ci_groups_finished",
  "window": {
    "days": 30,
    "from": "2026-08-25T08:00:00.000Z",
    "to": "2026-09-24T08:00:00.000Z"
  },
  "page": {
    "page": 1,
    "perPage": 10,
    "total": 1,
    "pageCount": 1
  },
  "errors": [
    {
      "fingerprint": "9c1e5a7f3b2d8e4c6a0f1b9…",
      "title": "toHaveText · getByTestId('ord…",
      "message": "Error: expect(locator).toHa…",
      "category": "Assertion Failures",
      "filePath": "tests/checkout.spec.ts",
      "fileCount": 1,
      "testCount": 1,
      "testNames": [
        "chromium > checkout.spec.ts > Checkou…"
      ],
      "occurrenceCount": 9,
      "runCount": 7,
      "failedCount": 5,
      "flakyCount": 2,
      "failedRunCount": 5,
      "flakyRunCount": 2,
      "massFailureRunCount": 0,
      "firstSeen": "2026-09-02T11:20:44.000Z",
      "lastSeen": "2026-09-24T07:34:05.000Z"
    }
  ],
  "unfingerprintedCount": 0,
  "unfinishedRuns": 0
}

{
  "error": "sha must be 4 to 40 hexadecimal c…",
  "code": "invalid_parameter"
}

{
  "error": "Invalid read key.",
  "code": "invalid_key"
}

{
  "error": "This organization has been delete…",
  "code": "organization_deleted"
}

{
  "error": "No project with this id in this o…",
  "code": "project_not_found"
}

{
  "error": "Too many requests with this read …",
  "code": "rate_limited"
}

{
  "error": "Something went wrong on our side.",
  "code": "internal_error"
}

Example values. The shape is generated from the API schema.

Ask about this pageChatGPT Claude

Responses

200400401403404429500

Read API

API reference

List errors

Parameters

Responses