---
title: "Cancel a batch job"
method: DELETE
path: "/v1/jobs/{batch_id}"
tags: ["core"]
---

# Cancel a batch job

`DELETE /v1/jobs/{batch_id}`

## Request

- Base URL: `https://api.voygr.tech`
- URL: `https://api.voygr.tech/v1/jobs/{batch_id}`
- Auth: API key in header `X-API-Key`

Request cancellation of a queued or running job (any type). Rows already processed are kept, billed, and downloadable; unprocessed rows are not charged.

## Path parameters

- `batch_id` string, required

## Response `200`

Successful Response

- ValidationJobDeleteResponse
  - `batch_id` string, required
  - `status` 'queued' | 'running' | 'completed' | 'failed' | 'cancelled', required

## Other responses

- `401`: Missing or invalid X-API-Key.
- `429`: Rate limit exceeded; wait and follow Retry-After when returned. Free keys are limited to 10 requests per second and 120 requests per minute, and can place 1 call at a time, up to 25 calls per day. Paid keys are limited to 10 requests per second and 120 requests per minute. A top-up raises a key's daily cap to 5,000 calls and its concurrent-call ceiling to 10. Enterprise limits are set per contract.

## Changes

- **2026-10-29** `03b7688c4c40`: 3 info
  - added the non-success response with the status `401`
  - added the non-success response with the status `429`
  - removed the non-success response with the status `422`
- **2026-09-16** `892990bd38e1`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/voygr/apis/voygr-calls-api/changes/v1/jobs/:batch_id/delete.md)

---

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