---
title: "Get all checkpoints across a project"
method: GET
path: "/workspaces/{workspace_id}/projects/{project_id}/checkpoints"
tags: ["Project pipeline checkpoints"]
---

# Get all checkpoints across a project

`GET /workspaces/{workspace_id}/projects/{project_id}/checkpoints`

## Request

- Base URL: `https://app.mammoth.io/api/v2`
- URL: `https://app.mammoth.io/api/v2/workspaces/{workspace_id}/projects/{project_id}/checkpoints`
- Auth: one of:
  - HTTP bearer
  - API key in header `X-API-KEY` and API key in header `X-API-SECRET` and API key in header `X-WORKSPACE-ID`

Returns checkpoints from all dataview pipelines in the project. Supports filtering by dataview, status, and sequence.

## Path parameters

- `workspace_id` integer, required: Workspace refers to a collection of projects. Workspace ID is unique identifier for workspace.
- `project_id` integer, required: Project ID of the workspace

## Query parameters

- `fields` string: Chekcpoint Fields to be returned in a comma-separated format. Check full mode for all fields.
- `sort` string: Returned results are sorted by the combination of the given fields.
- `dataview_id` integer, nullable: Returns only checkpoints belonging to the given dataview
- `sequence` integer, nullable: Returns all checkpoints where sequence matches the given value
- `status` 'pending' | 'needs_approval' | 'approved' | 'bypassed' | 'alert_sent': Returns all checkpoints where status matches the given value

## Response `200`

Success

- PipelineCheckpoints
  - `checkpoints` PipelineCheckpoint[], required
    - `id` integer, nullable
    - `dataview_id` integer, nullable
    - `checkpoint_type` 'alert' | 'approval'
    - `name` string, nullable
    - `task_sequence` integer, nullable
    - `status` 'pending' | 'needs_approval' | 'approved' | 'bypassed' | 'alert_sent': Returns all checkpoints where status matches the given value
    - `details` StoredCheckpointDetails
      - `alert_email_ids` string[]
      - `webhook_url` string, url, nullable
      - `message` string, nullable
    - `enabled` boolean, nullable
    - `pinned_to_end` boolean, nullable
    - `conditions` object, nullable
    - `created_at` string, date-time, nullable
    - `created_by` integer, nullable
    - `updated_at` string, date-time, nullable
    - `updated_by` integer, nullable
    - `last_triggered_at` string, date-time, nullable

## Other responses

- `400`: Bad request syntax or unsupported method
- `401`: Authorization error
- `403`: Request forbidden -- authorization will not help

---

[API](https://skmtc.dev/mammoth/apis/mammoth-analytics.md) · [All operations](https://skmtc.dev/mammoth/apis/mammoth-analytics/llms.txt) · [OpenAPI document](https://skmtc.dev/mammoth/apis/mammoth-analytics/revisions/fe078afe239b?raw)