---
title: "Submit a Mixed-Product Batch"
method: POST
path: "/v1/batch"
tags: ["Batch"]
---

# Submit a Mixed-Product Batch

`POST /v1/batch`

Submit a batch containing items for one or more enrichment products.

## Request body

- object
  - `items` object[], required — Batch items. Each item carries `product` (required for mixed-product batches), `input`, and optional `client_id`, `client_name`, and `metadata`.
    - `product` string — Product to run this item against.
    - `input` object — Product-specific input fields.
    - `client_id` string
    - `client_name` string
    - `metadata` object
  - `idempotencyKey` string — Submitting the same key twice returns the original batch instead of creating a duplicate.
  - `metadata` object — Arbitrary metadata stored with the batch.
  - `client_id` string — Associate the whole batch with a client record.
  - `client_name` string — Client name recorded alongside the batch.
  - `budget_user_id` string — Charge the batch against this member's credit budget.
  - `webhook_url` string, uri — HTTPS URL notified when the batch completes. SSRF-validated — must resolve to a public IP.
  - `priority` 'normal' | 'low' — Queue priority for this batch.

## Response `202`

Batch accepted.

- object

## Other responses

- `400` — Bad Request - The request was malformed or contains invalid parameters. **Common causes:** - Missing required fields - Invalid field format (e.g., malformed email) - Invalid JSON syntax - Invalid parameter values
- `401` — Unauthorized - Authentication failed. **Common causes:** - Missing X-API-Key header - Invalid or expired API key - Malformed API key

---

[API](https://skmtc.net/leadmagic/apis/leadmagic-api.md) · [All operations](https://skmtc.net/leadmagic/apis/leadmagic-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/leadmagic/leadmagic-api/revisions/aa19cf9bc46a/schema)