---
title: "Run up to 20 GET requests in one call"
method: POST
path: "/v1/batch"
---

# Run up to 20 GET requests in one call

`POST /v1/batch`

## Request

- Base URL: `https://shipshapedata.com/api`
- URL: `https://shipshapedata.com/api/v1/batch`
- Auth: none declared

Bulk read: send a list of GET paths (with query strings) and receive each result in order. Useful for fetching services, case studies, and categories in a single round trip.

## Headers

- `Idempotency-Key` string

## Request body

- object
  - `requests` object[], required
    - `path` string, required: A GET path, e.g. /v1/services or /v1/resources?q=lineage

## Response `200`

Per-request results in order

- BatchResponse
  - `responses` object[], required
    - `path` string, required
    - `status` integer, required
    - `body` object, required: The same shape the GET endpoint returns, or an Error object on 404

## Other responses

- `400`: Invalid input

---

[API](https://skmtc.dev/shipshapedata/apis/shipshape-data-api.md) · [All operations](https://skmtc.dev/shipshapedata/apis/shipshape-data-api/llms.txt) · [OpenAPI document](https://skmtc.dev/shipshapedata/apis/shipshape-data-api/revisions/2d494a3e5dbc?raw)