---
title: "Download Batch Enrichment Results (Direct)"
method: GET
path: "/public/v1/enrichment/batch/{batch_id}/"
tags: ["Batch enrichment"]
---

# Download Batch Enrichment Results (Direct)

`GET /public/v1/enrichment/batch/{batch_id}/`

## Request

- Base URL: `https://api-dashboard.influencers.club`
- URL: `https://api-dashboard.influencers.club/public/v1/enrichment/batch/{batch_id}/`
- Auth: HTTP bearer
- TypeScript: <https://skmtc.dev/influencers/apis/core-api-concepts/docs/public/v1/enrichment/batch/:batch_id/get.ts> (a function with typed inputs; its response is checked against the schema)

Download the final enriched dataset after processing is complete.

> **Tip:** For CSV downloads, consider using the **recommended** endpoint `GET /public/v1/enrichment/batch/{batch_id}/download/` instead — it returns a presigned URL for faster, more reliable downloads. Use this endpoint if you need **JSON** output or as a fallback.

**Requirements**

- Batch must be in `finished` status
- Results file must have been generated

**Output formats**

- **CSV** (default) — omit `format` or pass `?format=csv`
- **JSON** — pass `?format=json` to receive a JSON array where each object has:
&nbsp;&nbsp;- `input_value` — the original input (handle or email)
&nbsp;&nbsp;- `status` — enrichment status for that record
&nbsp;&nbsp;- `enrichment_data` — the enriched creator data

**Error Responses**

Every error response shares the canonical shape `{"error": <message>, "error_code": <slug>, ...}`. Branch programmatically on `error_code` rather than parsing `error`.

- `400 Bad Request` (`error_code: "batch_not_ready"`) — batch not completed yet; `current_status` is included in the body
- `400 Bad Request` (`error_code: "no_results"`) — batch finished but produced no rows
- `400 Bad Request` (`error_code: "results_not_ready"`) — batch finished but the results file is still being assembled
- `404 Not Found` (`error_code: "batch_not_found"`) — invalid batch ID or batch does not belong to client
- `500 Server Error` (`error_code: "service_error"`) — results file could not be retrieved from storage; safe to retry

**Credits**

- **0 credits** (download only)

<div class="ic-ai-prompt-root" data-endpoint="batch-download"></div>

## Path parameters

- `batch_id` string, required

## Query parameters

- `format` 'csv' | 'json'

## Response `200`

CSV or JSON file with enriched results depending on the `format` query parameter.

- object[]
  - `input_value` string
  - `status` string
  - `enrichment_data` object

## Other responses

- `400`: Bad Request — batch state prevents download.
- `401`: Unauthorized — missing or invalid API key.
- `403`: Forbidden — caller is not permitted to perform this action.
- `404`: Batch not found.
- `422`: Unprocessable entity — validation failed.
- `429`: Too Many Requests — rate or capacity limit exceeded. Inspect the `Retry-After` header and the `retry_after` body field for the wait time in seconds.
- `500`: Server Error — results file could not be retrieved from storage.

## Changes

- **2026-08-18** `87e654ac822e`: 14 info
  - added the media type `application/json` for the response with the status `400`
  - added the non-success response with the status `403`
  - added the non-success response with the status `429`
  - added the non-success response with the status `500`
  - …10 more

[Operation history](https://skmtc.dev/influencers/apis/core-api-concepts/changes/public/v1/enrichment/batch/:batch_id/get.md)

---

[API](https://skmtc.dev/influencers/apis/core-api-concepts.md) - [All operations](https://skmtc.dev/influencers/apis/core-api-concepts/llms.txt) - [OpenAPI document](https://skmtc.dev/influencers/apis/core-api-concepts/revisions/11c76bf81bec?raw)