---
title: "Get bulk recalls batch status"
method: GET
path: "/v1/recalls-batch/status"
tags: ["Recalls"]
---

# Get bulk recalls batch status

`GET /v1/recalls-batch/status`

## Request

- Base URL: `https://api.carsxe.com`
- URL: `https://api.carsxe.com/v1/recalls-batch/status`
- Auth: one of:
  - API key in query parameter `key`
  - API key in header `X-CarsXE-Batch-Token`
- TypeScript: <https://skmtc.dev/carsxe/apis/carsxe-api/docs/v1/recalls-batch/status/get.ts> (a function with typed inputs; its response is checked against the schema)

Check the processing status of a previously submitted batch.

## Query parameters

- `batchId` string, required

## Headers

- `X-CarsXE-Batch-Token` string

## Response `200`

Batch status retrieved.

- object
  - `success` boolean
  - `data` object
    - `batchId` string
    - `numericBatchId` integer
    - `status` string
    - `totalVins` integer

## Other responses

- `400`: Missing batchId parameter.
- `401`: Missing API key, unknown/disabled API key, or inactive account.
- `404`: Batch not found or not accessible with this API key.

---

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