Get test attempts

Get a test’s attempts in a run, with the Copy-for-AI prompt. Every attempt of one test in one run, oldest first, each with its errors, code frame and a ready-made prompt for an assistant that has the repository open (null for an attempt without a real failure). Cheap.

GET/api/v1/projects/{projectId}/runs/{runId}/tests/{testName}

Parameters

Parameter	Description
`projectId`string · pathrequired	A project id from GET /projects.
`runId`string · pathrequired	A run id from GET /projects/{projectId}/runs - or any shard’s id of a sharded run.
`testName`string · pathrequired	The full test name as Squally stores it (Playwright’s title path). URL-encode it, including “/” as %2F. A name used in several spec files needs ?filePath=.
`filePath`string	The spec file of the test, as stored (e.g. tests/checkout.spec.ts); an empty value means a test with no file. Needed only when the name exists in several files - the 400 ambiguous_test answer lists them.

Request

BASE="https://app.squally.dev/api/v1"
URL="$BASE/projects/$PROJECT/runs/$RUN_ID/tests"
URL="$URL/$TEST_NAME"
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}`
  + `/runs/${runId}/tests/${testName}`;
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}/runs"
    f"/{run_id}/tests/{test_name}"
)
response = requests.get(
    url,
    headers={"Authorization": f"Bearer {key}"},
)
data = response.json()

{
  "project": {
    "id": "3f7c2a91-5b8e-4d0a-9c61-2e4b7f0d8a…",
    "name": "storefront-web"
  },
  "run": {
    "id": "b1e0c6d2-7a43-4f19-8d5e-0c3a9e6f2b…",
    "runNumber": 1284,
    "branch": "main"
  },
  "test": {
    "name": "chromium > checkout.spec.ts > Ch…",
    "filePath": "tests/checkout.spec.ts"
  },
  "attempts": [
    {
      "retry": 0,
      "label": "first try",
      "status": "failed",
      "durationMs": 6210,
      "timedOut": false,
      "timeoutMs": 30000,
      "browserName": "chromium",
      "errors": [
        {
          "message": "Error: expect(locator).…",
          "stack": "Error: expect(locator).to…",
          "snippet": "  46 |   await page.get…",
          "location": {
            "file": "tests/checkout.spec.ts",
            "line": 48,
            "column": 52
          }
        }
      ],
      "copyPrompt": "You have the repository …",
      "shard": {
        "index": 1,
        "runId": "b1e0c6d2-7a43-4f19-8d5e-0c3a…"
      },
      "annotations": [
        {
          "type": "issue",
          "description": "https://github.com/…",
          "location": "tests/checkout.spec.ts:…"
        }
      ],
      "annotationsOmitted": 0,
      "location": {
        "line": 41,
        "column": 5
      },
      "workerIndex": 2,
      "parallelIndex": 2,
      "startedAt": "2026-10-30T09:14:07.412Z"
    },
    {
      "retry": 1,
      "label": "retry #1",
      "status": "passed",
      "durationMs": 1840,
      "timedOut": false,
      "timeoutMs": 30000,
      "browserName": "chromium",
      "errors": [],
      "copyPrompt": null,
      "shard": {
        "index": 1,
        "runId": "b1e0c6d2-7a43-4f19-8d5e-0c3a…"
      },
      "annotations": [
        {
          "type": "issue",
          "description": "https://github.com/…",
          "location": "tests/checkout.spec.ts:…"
        }
      ],
      "annotationsOmitted": 0,
      "location": {
        "line": 41,
        "column": 5
      },
      "workerIndex": 5,
      "parallelIndex": 2,
      "startedAt": "2026-10-30T09:14:14.180Z"
    }
  ]
}

{
  "error": "Several tests have this name. Pas…",
  "code": "ambiguous_test"
}

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

Get test attempts

Parameters

Responses