---
title: "✨ Get state backfill status"
method: GET
path: "/api/fsm/backfill/status/"
tags: ["States"]
---

# ✨ Get state backfill status

`GET /api/fsm/backfill/status/`

<Card href="https://humansignal.com/goenterprise">
        <img style="pointer-events: none; margin-left: 0px; margin-right: 0px;" src="https://docs.humansignal.com/images/badge.svg" alt="Label Studio Enterprise badge"/>
        <p style="margin-top: 10px; font-size: 14px;">
            This endpoint is not available in Label Studio Community Edition. [Learn more about Label Studio Enterprise](https://humansignal.com/goenterprise)
        </p>
    </Card>
Retrieve the status of a state backfill job for the authenticated user's active organization. By default returns the aggregated org status, or specify job_id or project_id to get explicit job statuses. Shows progress, completion time, and any errors. Requires administrator or owner role and state management access.

## Query parameters

- `job_id` integer
- `project_id` integer

## Response `200`

- StateBackfillStatusResponse
  - `completed_at` string, date-time, nullable
  - `created_at` string, date-time, nullable
  - `error_message` string, nullable
  - `job_id` integer — Job ID (if fetching a specific job)
  - `org_status` StateBackfillOrgStatus
    - `completed_projects` integer, required
    - `failed_projects` integer, required
    - `pending_projects` integer, required
    - `running_projects` integer, required
    - `total_entities_processed` integer, required
    - `total_projects` integer, required — Total projects in organization
  - `progress` StateBackfillProgress
    - `failed_projects` integer — Projects that failed
    - `successful_projects` integer — Projects completed successfully
    - `total_entities_processed` integer — Total entities processed so far
    - `total_projects` integer — Total projects involved
  - `rq_job_id` string, nullable
  - `rq_job_info` object, nullable
  - `started_at` string, date-time, nullable
  - `status` string
  - `triggered_by` StateTriggeredBy
    - `email` string, required
    - `first_name` string, nullable
    - `id` integer, required
    - `last_name` string, nullable

## Other responses

- `403`
- `404`

---

[API](https://skmtc.net/humansignal/apis/label-studio-api.md) · [All operations](https://skmtc.net/humansignal/apis/label-studio-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/humansignal/label-studio-api/revisions/89caa2dca86f/schema)