---
title: "Get the state of a job"
method: GET
path: "/api/v1/scheduling/jobs/{job_id}/state"
tags: ["Scheduling"]
---

# Get the state of a job

`GET /api/v1/scheduling/jobs/{job_id}/state`

## Request

- Base URL: `https://pcp.example.com`
- URL: `https://pcp.example.com/api/v1/scheduling/jobs/{job_id}/state`
- Auth: HTTP bearer

## Path parameters

- `job_id` string, uuid, required

## Query parameters

- `organization_id` string, uuid

## Response `200`

OK

- State: State schema
  - `chunks` object
    - `cached` integer
    - `cached_size` integer
    - `error` integer
    - `ok` integer
    - `size` integer
    - `total` integer
  - `dirs` object
    - `cached` integer
    - `cached_size` integer
    - `error` integer
    - `ok` integer
    - `size` integer
    - `total` integer
  - `files` object
    - `cached` integer
    - `cached_size` integer
    - `error` integer
    - `ok` integer
    - `size` integer
    - `total` integer
  - `io` object
  - `latency` object[]
    - `at` integer
    - `avg` integer
    - `count` integer
    - `max` integer
    - `p50` integer
    - `p95` integer
  - `network` object[]
    - `at` integer
    - `read_bps` number, double
    - `write_bps` number, double
  - `num_cpu` integer
  - `objects` object
    - `cached` integer
    - `cached_size` integer
    - `error` integer
    - `ok` integer
    - `size` integer
    - `total` integer
  - `paths` object
    - `cached` integer
    - `cached_size` integer
    - `error` integer
    - `ok` integer
    - `size` integer
    - `total` integer
  - `phase` string
  - `processed` object
    - `bytes` integer
    - `items` integer
  - `recent_paths` object[]
    - `path` string
    - `status` string
  - `resources` object[]
    - `at` integer
    - `cpu_percent` number, double
    - `memory_bytes` integer
  - `result` object
    - `duration` number, double
    - `errors` integer
    - `size` integer
  - `snapshot_id` string
  - `summary` object
    - `directories` integer
    - `exists` boolean
    - `files` integer
    - `paths` integer
    - `size` integer
    - `symlinks` integer
    - `xattrs` integer
  - `symlinks` object
    - `cached` integer
    - `cached_size` integer
    - `error` integer
    - `ok` integer
    - `size` integer
    - `total` integer
  - `version` string
  - `xattrs` object
    - `cached` integer
    - `cached_size` integer
    - `error` integer
    - `ok` integer
    - `size` integer
    - `total` integer

## Other responses

- `400`: Bad Request _(validation or deserialization error)_
- `401`: Missing, invalid or expired credentials
- `403`: The caller may not do this
- `500`: Internal Server Error _(panics)_
- `default`

---

[API](https://skmtc.dev/plakar/apis/plakar-control-plane-api-v1.md) - [All operations](https://skmtc.dev/plakar/apis/plakar-control-plane-api-v1/llms.txt) - [OpenAPI document](https://skmtc.dev/plakar/apis/plakar-control-plane-api-v1/revisions/2ac049494a01?raw)