---
title: "Batch state and per-domain results (grade, overall, refused, report links)"
method: GET
path: "/api/batch/{id}"
---

# Batch state and per-domain results (grade, overall, refused, report links)

`GET /api/batch/{id}`

## Request

- Base URL: `https://crawlcheck.io`
- URL: `https://crawlcheck.io/api/batch/{id}`
- Auth: one of:
  - API key in header `x-crawlcheck-key`
  - HTTP bearer

## Path parameters

- `id` string, required

## Headers

- `x-crawlcheck-key` string, required

## Response `200`

JSON

- object, nullable
  - `id` string, nullable
  - `state` string, nullable
  - `created` string, nullable
  - `started` unknown
  - `finished` unknown
  - `counts` object, nullable
    - `total` number, nullable
    - `queued` number, nullable
    - `done` number, nullable
    - `failed` number, nullable
  - `next_window` string, nullable
  - `windows_utc_minutes` number[], nullable
  - `webhook` object, nullable
    - `url` string, nullable
    - `status` unknown
  - `rejected` unknown[], nullable
    - unknown
  - `items` object[], nullable
    - `domain` string, nullable
    - `state` string, nullable
    - `id` unknown
    - `grade` unknown
    - `overall` unknown
    - `refused` boolean, nullable
    - `report` unknown
    - `json` unknown
    - `error` unknown
    - `at` unknown
  - `limits` string[], nullable

## Other responses

- `404`: Unknown id or not your batch

---

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