---
title: "List finished checks"
method: GET
path: "/v1/checks"
tags: ["Other"]
---

# List finished checks

`GET /v1/checks`

## Request

- Base URL: `https://api.taada.dev`
- URL: `https://api.taada.dev/v1/checks`
- Auth: HTTP bearer

Finished checks of this workspace, newest first. Each is the same object `GET /v1/checks/:id` returns, and every test in it names its `tags` and `ref`. With `failure=`, `tag=` or `ref=` a page may be short, or empty, with more behind it: follow `pagination.next` until it is null.

## Query parameters

- `app` string, uuid
- `result` 'passed' | 'blocked' | 'did_not_finish'
- `failure` 'app_broke' | 'test_out_of_date' | 'could_not_get_in' | 'tada_did_not_finish'
- `tag` string
- `ref` string
- `version` string
- `since` string, date-time
- `limit` integer
- `cursor` string

## Response `200`

Default Response

- object
  - `data` object[], required
  - `pagination` object, required
    - `next` string, nullable, required

## Other responses

- `400`: Default Response
- `404`: Default Response
- `429`: Default Response

---

[API](https://skmtc.dev/taada/apis/tada.md) · [All operations](https://skmtc.dev/taada/apis/tada/llms.txt) · [OpenAPI document](https://skmtc.dev/taada/apis/tada/revisions/9079c5c8a580?raw)