Public reports and badges

The data and images of a published Qualflare report are served without a token at https://api.qualflare.com/p/<project-identifier>/: a README badge and banner, social images, and read-only JSON for its launches.

Public URLs

Each path follows the base URL, and <n> is a launch's number. The last column gives the browser max-age and the edge s-maxage, in seconds.

Badge

The badge shows the newest launch of the report, with the label qualflare.

The badge always loads: an unknown or private project shows no runs, never a broken image. GitHub shows README images through its own image proxy, which can keep an older badge for a while. To add it to a README, see Embeddable badge.

Banner

banner.svg is a 1280 × 232 image with the project name (or the linked owner/repo), pass rate, run count, flaky-case count, last-run time and a grid of recent runs. An unknown or private project gets a plain banner. For the Markdown and the light and dark note, see Embeddable banner.

Social images

Slack, Discord and X show og.png when someone shares the launches page, and launches/<n>/og.png for one run: 1200 × 630 PNG cards. The launches card sums up the 60 newest launches. A missing project or run gets a generic card.

Read launches as JSON

Launches

/launches returns the project (slug, name, description, and githubUrl when a repository is linked) and its launches, newest first. limit takes 1 or more, 25 by default, and counts anything over 100 as 100. offset takes 0 or more.

curl -sS \
  "https://api.qualflare.com/p/<project-identifier>/launches?limit=10"

{
  "project": { "slug": "myapp", "name": "My App", "description": "End-to-end tests", "githubUrl": "https://github.com/my-org/myapp" },
  "launches": [
    {
      "seq": 42, "status": "failed", "framework": "playwright", "platform": "web", "os": "linux",
      "browser": null, "language": "en-US", "branch": "main", "commit": "4f1c2ab",
      "ciProvider": null, "ciBuildNumber": null, "ciPrNumber": null,
      "totalCount": 120, "passedCount": 115, "failedCount": 2, "errorCount": 0, "skippedCount": 3,
      "timeoutCount": 0, "abortedCount": 0, "flakyCount": 1, "retryCount": 4,
      "startedAt": "2026-11-02T09:14:03Z", "endedAt": "2026-11-02T09:18:41Z"
    }
  ]
}

Launch fields

browser, branch, commit and the three CI fields are null when the upload didn't send them. Public answers leave out a launch's properties, metadata, AI summary, environment, milestone, test plan and CI run URL.

Failures and cases

• /failures returns {"failures": […], "truncated": false}: the failed, error, timed-out and aborted tests, at most 200.
• /cases returns {"cases": […], "truncated": false}: every test, at most 500, by suite and name.
• truncated is true when the list was cut.
• Each test has suite, test, seq (the test case's number), status, durationMs, failure (null unless it failed), flaky, retries, priority and automated. /cases/retried also gives attemptStatuses, each attempt's status in order, when the upload recorded attempts.
• /cases/retried and /cases/slowest return the same cases list, 6 tests by default. limit takes 1 or more and counts anything over 20 as 20.

Project and latest launch

/meta returns the project's slug, name and description, its githubUrl when a repository is linked, and latest: its newest launch, or null while the report has no launch.

Caching

Qualflare's edge caches these answers. A running launch is cached for 30 seconds, a finished one for up to an hour, the badge and banner for a minute. Cached pages can stay visible for up to about an hour. This applies after you unpublish too: Turning it on. Every other API route sends Cache-Control: no-store.

Errors

The badge, banner and social images answer 200 with a generic image for a missing, private or suspended project, or a bad run number. Every status: Errors and status codes.

Search engines

reports.qualflare.com lists each report's launches page in its sitemap and lets search engines index it; single-run pages are noindex.

Related

• Guides: Publishing a Report · Setting Up CI
• Reference: Launches API · Rate limits and request sizes
• CLI/API: Qualflare API