---
title: "Get Bulk Status"
method: GET
path: "/bulks/{bulk_id}"
tags: ["Bulks"]
---

# Get Bulk Status

`GET /bulks/{bulk_id}`

Returns the status and metrics for a bulk job. Works for both consent and verification bulks. The `type` field tells you which kind of bulk this is.

## Path parameters

- `bulk_id` string, uuid, required

## Response `200`

Bulk status retrieved successfully.

- Bulk
  - `bulk_id` string, uuid, required — Unique identifier for this bulk job.
  - `external_id` string, nullable — Optional external identifier passed at creation, used to correlate with your internal systems.
  - `type` 'consent' | 'verification', required — Type of bulk job.
  - `created_at` string, date-time, required — Timestamp of when the bulk was created.
  - `metrics` object, required
    - `total` integer, required — Total number of items in the bulk.
    - `completed` integer, required — Items that completed successfully.
    - `failed` integer, required — Items that failed. See `status_code` on each item for the reason.
    - `in_progress` integer, required — Items still being processed.

## Other responses

- `401` — Unauthorized - Invalid or missing API key.
- `404` — Bulk not found.

---

[API](https://skmtc.net/burodeingresos/apis/bur-de-ingresos-api.md) · [All operations](https://skmtc.net/burodeingresos/apis/bur-de-ingresos-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/burodeingresos/bur-de-ingresos-api/versions/59e48cdbdd84/schema)