---
title: "✨ Get Agreement V2 backfill status"
method: GET
path: "/api/dimensions/backfill/status/"
tags: ["Dimensions"]
---

# ✨ Get Agreement V2 backfill status

`GET /api/dimensions/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 an Agreement V2 backfill job for the authenticated user's active organization. By default returns the aggregated organization status. Specify job_id or project_id to get a specific job status. Requires administrator or owner role and Agreement V2 access.

## Query parameters

- `job_id` integer
- `project_id` integer

## Response `200`

- AgreementV2BackfillJob — Serializes a DimensionsBackfillJob model instance. Used by the list endpoint and as the base for the status endpoint.
  - `completed_at` string, date-time, nullable
  - `created_at` string, date-time, required
  - `error_message` string — Error message if job failed
  - `job_id` integer, required — Database ID of the backfill job
  - `progress_data` unknown
  - `project_id` integer, nullable, required — Optional specific project to backfill (if null, backfills entire organization)
  - `rq_job_id` string, nullable, required — Redis queue job ID
  - `started_at` string, date-time, nullable
  - `status` 'PENDING' | 'QUEUED' | 'RUNNING' | 'COMPLETED' | 'FAILED' — * `PENDING` - Pending * `QUEUED` - Queued * `RUNNING` - Running * `COMPLETED` - Completed * `FAILED` - Failed
  - `triggered_by` object, nullable, required — User who triggered the backfill

## 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/versions/1b113b8df950/schema)