---
title: "List a job's checkpoints"
---

> Documentation Index
> Fetch the complete documentation index at: https://www.arroyo.dev/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# List a job's checkpoints

Path: Arroyo REST API › jobs

`GET /v1/pipelines/{pipeline_id}/jobs/{job_id}/checkpoints`

URL: `http://localhost:5115/api/v1/pipelines/{pipeline_id}/jobs/{job_id}/checkpoints`

## Path parameters

- `pipeline_id` (`get_job_checkpoints.path.pipeline_id`; string, required) — Pipeline id
- `job_id` (`get_job_checkpoints.path.job_id`; string, required) — Job id

## Code samples

### cURL

```bash
curl --request GET \
  --url 'http://localhost:5115/api/v1/pipelines/<pipeline_id>/jobs/<job_id>/checkpoints'
```

### TypeScript

```typescript
const url = 'http://localhost:5115/api/v1/pipelines/<pipeline_id>/jobs/<job_id>/checkpoints';
const options = {method: 'GET'};

fetch(url, options)
  .then(res => res.json())
  .then(json => console.log(json))
  .catch(err => console.error(err));
```

### Python

```python
import requests

url = "http://localhost:5115/api/v1/pipelines/<pipeline_id>/jobs/<job_id>/checkpoints"

response = requests.get(url)

print(response.text)
```

## Responses

### 200

Got job's checkpoints

#### Example

```json
{
  "data": [
    {
      "backend": "string",
      "checkpoint_type": "scheduled",
      "epoch": 0,
      "events": [
        {
          "description": "string",
          "event": "string",
          "finish_time": 0,
          "start_time": 0
        }
      ],
      "finish_time": 0,
      "start_time": 0
    }
  ]
}
```

- `data` (`get_job_checkpoints.response.200.data`; array of object, required)
  - `backend` (`get_job_checkpoints.response.200.data.backend`; string, required)
  - `checkpoint_type` (`get_job_checkpoints.response.200.data.checkpoint_type`; string, required)
    - one of `"scheduled"`, `"stopping"`
  - `epoch` (`get_job_checkpoints.response.200.data.epoch`; integer, required)
    - format: `int64` · minimum: `0`
  - `events` (`get_job_checkpoints.response.200.data.events`; array of object, required)
    - `description` (`get_job_checkpoints.response.200.data.events.description`; string, required)
    - `event` (`get_job_checkpoints.response.200.data.events.event`; string, required)
    - `finish_time` (`get_job_checkpoints.response.200.data.events.finish_time`; integer, required)
      - format: `int64` · minimum: `0`
    - `start_time` (`get_job_checkpoints.response.200.data.events.start_time`; integer, required)
      - format: `int64` · minimum: `0`
  - `start_time` (`get_job_checkpoints.response.200.data.start_time`; integer, required)
    - format: `int64` · minimum: `0`
  - `finish_time` (`get_job_checkpoints.response.200.data.finish_time`; integer, optional, nullable)
    - format: `int64` · minimum: `0`


Source: https://www.arroyo.dev/docs/api/get-job-checkpoints/index.md
