Skip to main content
GET
Poll an async batch

Overview

Returns the state and row counts of an asynchronous batch. Poll until status is terminal, then fetch results.

Authorizations

Authorization
string
header
required

Morph API key, passed as Authorization: Bearer sk-.... Create keys at https://www.morphllm.com/dashboard/api-keys.

Path Parameters

batch_id
string
required

The batch to poll, as returned in id when you queued it. Identifier returned by the async batch upload.

Example:

"rbatch-a1b2c3d4-5e6f-7a8b-9c0d-1e2f3a4b5c6d"

Response

Batch status.

Async batch status. status moves queued → in_progress → completed.

id
string
required

Identifier for the queued batch.

Example:

"rbatch-a1b2c3d4-5e6f-7a8b-9c0d-1e2f3a4b5c6d"

object
string
required

Object type, always reflex.batch.

Example:

"reflex.batch"

status
enum<string>
required

Where the batch is in the queue.

Available options:
queued,
in_progress,
completed
Example:

"queued"

request_counts
object
required

Progress counters, advancing as the worker drains the queue.

Example:
created_at
integer
required

Unix timestamp (seconds).

Example:

1780000000