---
title: "Get up to 50 services in one call"
method: POST
path: "/services/batch"
tags: ["Discovery"]
---

# Get up to 50 services in one call

`POST /services/batch`

## Request

- Base URL: `https://codeatlas.com.br/api/v1`
- URL: `https://codeatlas.com.br/api/v1/services/batch`
- Auth: none required

Looks up each slug and returns one result per slug, in request order. A missing or non-string slug does not fail the request: its result carries status and an error object. Public, no token.

## Request body

- BatchRequest
  - `slugs` string[], required: Service slugs, 1 to 50.

## Response `200`

One result per requested slug.

- BatchResponse
  - `count` integer, required
  - `results` BatchResult[], required
    - `slug` string, nullable, required
    - `status` integer, required: HTTP-style status of this item: 200, 404 or 400.
    - `data` Service
      - `slug` string, required: Stable service identifier.
      - `name` string, required: Human-readable service name.
      - `description` string, required: Plain-language service description.
      - `serviceType` string, required: Structured service category.
      - `url` string, uri, required: Canonical service page.
      - `capabilities` string[], required: Capabilities included in the service.
      - `deliveryTimeline` string, required: Typical initial delivery timeline. An estimate, not a commitment.
    - `error` object
      - `code` string, required
      - `message` string, required
      - `hint` string, required

## Other responses

- `400`: The request is malformed: invalid query parameter, invalid JSON or invalid Idempotency-Key.
- `405`: The HTTP method is not supported.
- `413`: The body is larger than 16384 bytes.
- `415`: The body must be application/json.
- `422`: A field failed validation, or the Idempotency-Key was reused with a different body.
- `429`: Rate limit exceeded. Wait Retry-After seconds.
- `default`: Unexpected error. Same shape as every other error.

---

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