---
title: "Poll batch lookup status"
method: GET
path: "/v1/satellite/creators/batch/{batch_id}"
tags: ["Satellite"]
---

# Poll batch lookup status

`GET /v1/satellite/creators/batch/{batch_id}`

## Request

- Base URL: `https://api.virlo.ai`
- URL: `https://api.virlo.ai/v1/satellite/creators/batch/{batch_id}`
- Auth: HTTP bearer

Returns the aggregate status of a batch created via POST /v1/satellite/creators/batch. Each creator shows its current status (processing, completed, or failed). Batch results expire after 24 hours.

## Path parameters

- `batch_id` string, required

## Response `200`

Batch status with per-creator progress

- BatchLookupStatusResponseDto
  - `data` BatchLookupResultDto, required
    - `batch_id` string, required
    - `status` 'processing' | 'completed' | 'partial' | 'failed', required
    - `total` number, required
    - `completed` number, required
    - `failed` number, required
    - `processing` number, required
    - `creators` BatchCreatorJobItemDto[], required
      - `platform` string, required
      - `username` string, required
      - `job_id` string, required
      - `status` 'processing' | 'completed' | 'failed', required: "completed" at submit time means the creator was answered from the 6-hour cache and was not billed.

## Other responses

- `401`: Unauthorized - missing or invalid API key
- `404`: Batch not found or expired
- `429`: Rate limit exceeded (`rate_limit_exceeded`); see the Retry-After header

---

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