---
title: "Run a batch of discovery reads"
method: POST
path: "/batch"
tags: ["Discovery", "Search"]
---

# Run a batch of discovery reads

`POST /batch`

## Request

- Base URL: `https://zephior.com/api/v1`
- URL: `https://zephior.com/api/v1/batch`
- Auth: none required

Runs 1 to 25 site-overview or resource-search operations in one idempotent request.

## Headers

- `Idempotency-Key` string, required

## Request body

- BatchRequest
  - `requests` object[], required
    - `operation` 'site' | 'search', required
    - `query` string
    - `locale` 'en' | 'de' | 'fr'

## Response `200`

Ordered batch results

- BatchResponse
  - `idempotencyKey` string, required
  - `count` integer, required
  - `responses` object[], required

## Other responses

- `400`: Invalid request or query parameter.
- `429`: Public API rate limit exceeded.
- `500`: Unexpected server error.

---

[API](https://skmtc.dev/zephior/apis/zephior-public-discovery-api.md) · [All operations](https://skmtc.dev/zephior/apis/zephior-public-discovery-api/llms.txt) · [OpenAPI document](https://skmtc.dev/zephior/apis/zephior-public-discovery-api/revisions/3d7585b2bd5a?raw)