---
title: "Get a bulk request's status"
method: GET
path: "/v1/ads/catalogs/{catalogId}/batches/{handle}"
tags: ["Product Catalogs"]
---

# Get a bulk request's status

`GET /v1/ads/catalogs/{catalogId}/batches/{handle}`

## Path parameters

- `catalogId` string, required
- `handle` string, required

## Query parameters

- `accountId` string, required
- `catalogAccountId` string

## Response `200`

Batch status

- object
  - `batch` object
    - `handle` string
    - `status` string — Meta's status, e.g. initial, in_progress, finished
    - `errorsTotalCount` integer
    - `errors` object[]
      - `retailerId` string, nullable
      - `message` string

## Other responses

- `400` — Invalid request
- `401` — Unauthorized
- `403` — The Meta login behind the account lacks catalog_management (code insufficient_permissions). Reconnect granting it, or pass catalogAccountId.
- `404` — Resource not found

## Changes

- **2026-09-25** `2c04683ce694` — 8 info
  - added the optional property `details/adAccountId` to the response with the `400` status
  - added the optional property `details/adAccountId` to the response with the `403` status
  - added the optional property `details/createdObjects` to the response with the `400` status
  - added the optional property `details/createdObjects` to the response with the `403` status
  - …4 more
- **2026-09-17** `fdaf9a9fb1a7` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/zernio/apis/zernio-api/changes/v1/ads/catalogs/:catalogId/batches/:handle/get.md)

---

[API](https://skmtc.dev/zernio/apis/zernio-api.md) · [All operations](https://skmtc.dev/zernio/apis/zernio-api/llms.txt) · [OpenAPI document](https://skmtc.dev/zernio/apis/zernio-api/revisions/e0122970214f?raw)