List tests

Every test with a run of the source (all by default) in the period and its metrics - stability, flaky rate, failure rate, runs, time lost, its last 20 runs, the branches it ran on and where it fails most - ranked by the chosen sort. Counts finished runs of the source - all by default - without mass-failure runs, on every branch unless branch names one (see population). Moderate: aggregate queries over the period’s results of the source, paged in the database; use the metrics route for one test.

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

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.
`search`string	Case-insensitive substring of the test name or its file.
`branch`string	Only runs on this branch, the name exactly. Every branch when absent.
`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.
`browser`string	Only tests of this Playwright project - the items’ browser field, exactly (e.g. chromium). Every test when absent.
`sort`stability \| flakyRate \| failureRate \| runs \| timeLost · default stability	Ranking, the worst first: stability (the default) lowest first; flakyRate, failureRate, runs and timeLost highest first. Ties go to the most runs (for runs: the lowest stability), then to the test name and file. A rate with nothing to divide by (null) sorts after every number.
`page`integer · default 1	1-based page number. A page past the end answers the last page.
`perPage`integer · default 50	Rows per page, 1 to 100.

Request

BASE="https://app.squally.dev/api/v1"
URL="$BASE/projects/$PROJECT/tests"
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}`
  + `/tests`;
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}/tests"
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_not_mass_…",
  "days": 30,
  "since": "2026-08-25T08:00:00.000Z",
  "until": "2026-09-24T08:00:00.000Z",
  "branch": null,
  "browser": null,
  "sort": "stability",
  "page": 1,
  "perPage": 3,
  "total": 409,
  "pageCount": 137,
  "items": [
    {
      "testName": "chromium > checkout.spec.t…",
      "filePath": "tests/checkout.spec.ts",
      "browser": "chromium",
      "runs": 8,
      "stableRuns": 4,
      "flakyRuns": 4,
      "failedRuns": 0,
      "stability": 0.5,
      "flakyRate": 0.5,
      "failureRate": 0,
      "timeLostMs": 7361,
      "recentResults": [
        {
          "runId": "5c8e2a17-9d4b-4f60-b3a1-7…",
          "runNumber": 1261,
          "startedAt": "2026-09-12T07:30:41.0…",
          "branch": "main",
          "result": "stable"
        },
        {
          "runId": "c2e7a940-5d1b-4f8e-9a36-0…",
          "runNumber": 1264,
          "startedAt": "2026-09-14T15:12:09.0…",
          "branch": "feature/saved-carts",
          "result": "flaky"
        },
        {
          "runId": "a3f19c62-0e7d-4b85-9c24-6…",
          "runNumber": 1266,
          "startedAt": "2026-09-15T07:31:03.0…",
          "branch": "main",
          "result": "flaky"
        },
        {
          "runId": "d07b4e95-6a2c-4e13-8f5d-2…",
          "runNumber": 1270,
          "startedAt": "2026-09-17T07:29:58.0…",
          "branch": "main",
          "result": "flaky"
        },
        {
          "runId": "6b1f8d23-9e4a-4c07-b5d2-3…",
          "runNumber": 1273,
          "startedAt": "2026-09-18T11:47:35.0…",
          "branch": "feature/saved-carts",
          "result": "stable"
        },
        {
          "runId": "8f6a3d21-4c9e-4a7b-b052-e…",
          "runNumber": 1277,
          "startedAt": "2026-09-20T07:32:16.0…",
          "branch": "main",
          "result": "stable"
        },
        {
          "runId": "7d2f4b19-3c8e-4a61-9e07-5…",
          "runNumber": 1283,
          "startedAt": "2026-09-23T16:05:40.0…",
          "branch": "feature/saved-carts",
          "result": "stable"
        },
        {
          "runId": "b1e0c6d2-7a43-4f19-8d5e-0…",
          "runNumber": 1284,
          "startedAt": "2026-09-24T07:31:12.0…",
          "branch": "main",
          "result": "flaky"
        }
      ],
      "branches": [
        "feature/saved-carts",
        "main"
      ],
      "topBranch": {
        "branch": "main",
        "kind": "retries",
        "count": 3
      }
    },
    {
      "testName": "chromium > search.spec.ts …",
      "filePath": "tests/search.spec.ts",
      "browser": "chromium",
      "runs": 8,
      "stableRuns": 5,
      "flakyRuns": 0,
      "failedRuns": 3,
      "stability": 0.625,
      "flakyRate": 0,
      "failureRate": 0.375,
      "timeLostMs": 14308,
      "recentResults": [
        {
          "runId": "5c8e2a17-9d4b-4f60-b3a1-7…",
          "runNumber": 1261,
          "startedAt": "2026-09-12T07:30:41.0…",
          "branch": "main",
          "result": "stable"
        },
        {
          "runId": "c2e7a940-5d1b-4f8e-9a36-0…",
          "runNumber": 1264,
          "startedAt": "2026-09-14T15:12:09.0…",
          "branch": "feature/saved-carts",
          "result": "stable"
        },
        {
          "runId": "a3f19c62-0e7d-4b85-9c24-6…",
          "runNumber": 1266,
          "startedAt": "2026-09-15T07:31:03.0…",
          "branch": "main",
          "result": "stable"
        },
        {
          "runId": "d07b4e95-6a2c-4e13-8f5d-2…",
          "runNumber": 1270,
          "startedAt": "2026-09-17T07:29:58.0…",
          "branch": "main",
          "result": "failed"
        },
        {
          "runId": "6b1f8d23-9e4a-4c07-b5d2-3…",
          "runNumber": 1273,
          "startedAt": "2026-09-18T11:47:35.0…",
          "branch": "feature/saved-carts",
          "result": "stable"
        },
        {
          "runId": "8f6a3d21-4c9e-4a7b-b052-e…",
          "runNumber": 1277,
          "startedAt": "2026-09-20T07:32:16.0…",
          "branch": "main",
          "result": "failed"
        },
        {
          "runId": "7d2f4b19-3c8e-4a61-9e07-5…",
          "runNumber": 1283,
          "startedAt": "2026-09-23T16:05:40.0…",
          "branch": "feature/saved-carts",
          "result": "failed"
        },
        {
          "runId": "b1e0c6d2-7a43-4f19-8d5e-0…",
          "runNumber": 1284,
          "startedAt": "2026-09-24T07:31:12.0…",
          "branch": "main",
          "result": "stable"
        }
      ],
      "branches": [
        "feature/saved-carts",
        "main"
      ],
      "topBranch": {
        "branch": "main",
        "kind": "failures",
        "count": 2
      }
    },
    {
      "testName": "chromium > auth.spec.ts > …",
      "filePath": "tests/auth.spec.ts",
      "browser": "chromium",
      "runs": 7,
      "stableRuns": 6,
      "flakyRuns": 1,
      "failedRuns": 0,
      "stability": 0.8571428571428571,
      "flakyRate": 0.14285714285714285,
      "failureRate": 0,
      "timeLostMs": 3071,
      "recentResults": [
        {
          "runId": "5c8e2a17-9d4b-4f60-b3a1-7…",
          "runNumber": 1261,
          "startedAt": "2026-09-12T07:30:41.0…",
          "branch": "main",
          "result": "stable"
        },
        {
          "runId": "c2e7a940-5d1b-4f8e-9a36-0…",
          "runNumber": 1264,
          "startedAt": "2026-09-14T15:12:09.0…",
          "branch": "feature/saved-carts",
          "result": "flaky"
        },
        {
          "runId": "a3f19c62-0e7d-4b85-9c24-6…",
          "runNumber": 1266,
          "startedAt": "2026-09-15T07:31:03.0…",
          "branch": "main",
          "result": "stable"
        },
        {
          "runId": "d07b4e95-6a2c-4e13-8f5d-2…",
          "runNumber": 1270,
          "startedAt": "2026-09-17T07:29:58.0…",
          "branch": "main",
          "result": "skipped"
        },
        {
          "runId": "6b1f8d23-9e4a-4c07-b5d2-3…",
          "runNumber": 1273,
          "startedAt": "2026-09-18T11:47:35.0…",
          "branch": "feature/saved-carts",
          "result": "stable"
        },
        {
          "runId": "8f6a3d21-4c9e-4a7b-b052-e…",
          "runNumber": 1277,
          "startedAt": "2026-09-20T07:32:16.0…",
          "branch": "main",
          "result": "stable"
        },
        {
          "runId": "7d2f4b19-3c8e-4a61-9e07-5…",
          "runNumber": 1283,
          "startedAt": "2026-09-23T16:05:40.0…",
          "branch": "feature/saved-carts",
          "result": "stable"
        },
        {
          "runId": "b1e0c6d2-7a43-4f19-8d5e-0…",
          "runNumber": 1284,
          "startedAt": "2026-09-24T07:31:12.0…",
          "branch": "main",
          "result": "stable"
        }
      ],
      "branches": [
        "feature/saved-carts",
        "main"
      ],
      "topBranch": {
        "branch": "feature/saved-carts",
        "kind": "retries",
        "count": 1
      }
    }
  ]
}

{
  "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 tests

Parameters

Responses