---
title: "Retrieve a list of all checks"
method: GET
path: "/v1/deployments/{deploymentId}/checks"
tags: ["checks"]
deprecated: true
---

# Retrieve a list of all checks

`GET /v1/deployments/{deploymentId}/checks`

## Request

- Base URL: `https://api.vercel.com`
- URL: `https://api.vercel.com/v1/deployments/{deploymentId}/checks`
- Auth: HTTP bearer

> **Deprecated.**

List all of the checks created for a deployment.

## Path parameters

- `deploymentId` string, required: The deployment to get all checks for

## Query parameters

- `teamId` string
- `slug` string

## Response `200`

- object
  - `checks` object[], required
    - `blocking` false | true, required
    - `completedAt` number
    - `conclusion` 'canceled' | 'failed' | 'neutral' | 'skipped' | 'stale' | 'succeeded'
    - `createdAt` number, required
    - `detailsUrl` string
    - `id` string, required
    - `integrationId` string, required
    - `name` string, required
    - `output` object
      - `metrics` object
        - `CLS` object, required
          - `previousValue` number
          - `source` 'web-vitals', required
          - `value` number, nullable, required
        - `FCP` object, required
          - `previousValue` number
          - `source` 'web-vitals', required
          - `value` number, nullable, required
        - `LCP` object, required
          - `previousValue` number
          - `source` 'web-vitals', required
          - `value` number, nullable, required
        - `TBT` object, required
          - `previousValue` number
          - `source` 'web-vitals', required
          - `value` number, nullable, required
        - `virtualExperienceScore` object
          - `previousValue` number
          - `source` 'web-vitals', required
          - `value` number, nullable, required
    - `path` string
    - `rerequestable` false | true, required
    - `startedAt` number
    - `status` 'completed' | 'registered' | 'running', required
    - `updatedAt` number, required

## Other responses

- `400`: One of the provided values in the request query is invalid.
- `401`: The request is not authorized.
- `403`: You do not have permission to access this resource.
- `404`: The deployment was not found
- `410`

## Changes

- **2026-07-21** `2ae10ee9d21c`: 1 info
  - added the non-success response with the status `410`
- **2026-06-11** `14b4658f819e`: 1 info
  - endpoint deprecated
- **2026-01-22** `c12186034433`: 4 warning
  - added the new `false` enum value to the `checks/items/blocking` response property for the response status `200`
  - added the new `false` enum value to the `checks/items/rerequestable` response property for the response status `200`
  - added the new `true` enum value to the `checks/items/blocking` response property for the response status `200`
  - added the new `true` enum value to the `checks/items/rerequestable` response property for the response status `200`
- **2025-10-09** `50caddad4ae7`: 1 info
  - added the required property `checks/items/blocking` to the response with the `200` status
- **2025-03-19** `37b482c58c92`: 2 info
  - added the new optional `query` request parameter `slug`
  - added the non-success response with the status `401`

[Operation history](https://skmtc.dev/vercel/apis/vercel-api/changes/v1/deployments/:deploymentId/checks/get.md)

---

[API](https://skmtc.dev/vercel/apis/vercel-api.md) - [All operations](https://skmtc.dev/vercel/apis/vercel-api/llms.txt) - [OpenAPI document](https://skmtc.dev/vercel/apis/vercel-api/revisions/60686c0e1f6a?raw)