---
title: "List batch results"
method: GET
path: "/batch/{batch_id}/results"
tags: ["Batches"]
---

# List batch results

`GET /batch/{batch_id}/results`

## Request

- Base URL: `https://api.context.dev/v1`
- URL: `https://api.context.dev/v1/batch/{batch_id}/results`
- Auth: HTTP bearer

Page through a finished batch’s results as JSON. Each record contains result with the same outputs and per-format errors as POST /web/scrape. Results remain available for 180 days.

## Path parameters

- `batch_id` string, required: Batch ID.

## Query parameters

- `limit` integer: Records per page. Defaults to 25. A page can close early so its payload stays under ~8 MB; rely on next_cursor rather than counting records.
- `cursor` string: next_cursor from the previous page.

## Response `200`

One page of result records. Keep paging with `next_cursor` while `has_more` is true.

- object
  - `data` BatchResultRecord[]: Result records on this page.
    - union: One scrape outcome. result uses the single Scrape Anything response schema; itemId and meta identify your input.
      - object: At least one requested output succeeded. Check result.isPartial and each output success for incomplete results.
        - `url` string, required: URL as submitted, or as discovered by the crawl.
        - `itemId` string: Your `itemId` from submission.
        - `meta` object: Caller-supplied metadata echoed from submission.
        - `status` 'ok', required
        - `result` BatchScrapeResponse, required (unresolved $ref)
        - `credits_used` integer, required: Credits charged for this page, including OCR. Cached outputs use the same pricing as POST /web/scrape.
        - `ocr_pages` integer: PDF pages recovered by OCR. Omitted when OCR did not run.
      - object: A page the batch could not fetch.
        - `url` string, required: URL as submitted, or as discovered by the crawl.
        - `itemId` string: Your `itemId` from submission.
        - `meta` object: Caller-supplied metadata echoed from submission.
        - `status` 'error', required: The page could not be scraped.
        - `error_code` string, required: Why the page failed.
        - `message` string, required: Human-readable failure detail.
        - `result` BatchScrapeResponse (unresolved $ref)
        - `credits_used` integer: Credits charged for this page, including OCR. Cached outputs use the same pricing as POST /web/scrape.
        - `ocr_pages` integer: PDF pages recovered by OCR. Omitted when OCR did not run.
  - `has_more` boolean: Whether another page is available.
  - `next_cursor` string, nullable: Cursor for the next page.
  - `key_metadata` KeyMetadata: Credits this request used and your remaining balance.
    - `credits_consumed` integer, required: Credits charged for this request.
    - `credits_remaining` integer, required: Credits remaining for your organization.
  - `request_id` string, uuid, required: Unique ID of this request, also in `X-Request-Id`. Include it when contacting support.

## Other responses

- `400`: Bad request
- `401`: Unauthorized
- `403`: API key permissions or organization settings do not allow this request.
- `404`: Not found
- `409`: Batch has not finished yet (error_code BATCH_NOT_COMPLETED).
- `429`: Rate limit exceeded. Organization concurrency rejections include structured error_data and subscription settings; follow Retry-After before retrying.

## Changes

- **2026-10-21** `61627728926b`: 5 warning
  - added the new `NO_PUBLISHED_MARKDOWN` enum value to the `error_code` response property for the response status `400`
  - added the new `NO_PUBLISHED_MARKDOWN` enum value to the `error_code` response property for the response status `401`
  - added the new `NO_PUBLISHED_MARKDOWN` enum value to the `error_code` response property for the response status `403`
  - added the new `NO_PUBLISHED_MARKDOWN` enum value to the `error_code` response property for the response status `404`
  - …1 more
- **2026-10-19** `4ddcf49b9fe5`: 6 info
  - added the optional property `error_data` to the response with the `400` status
  - added the optional property `error_data` to the response with the `401` status
  - added the optional property `error_data` to the response with the `403` status
  - added the optional property `error_data` to the response with the `404` status
  - …2 more
- **2026-10-16** `2125f3e94e52`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/context/apis/brand-api/changes/batch/:batch_id/results/get.md)

---

[API](https://skmtc.dev/context/apis/brand-api.md) · [All operations](https://skmtc.dev/context/apis/brand-api/llms.txt) · [OpenAPI document](https://skmtc.dev/context/apis/brand-api/revisions/9e2ab7841fb1?raw)