> ## Documentation Index > Fetch the complete documentation index at: https://docs.runflow.io/llms.txt > Use this file to discover all available pages before exploring further. # Get batch callback delivery history > Get callback delivery history for a batch (with attempts eager-loaded). ## OpenAPI ````yaml /api/openapi.public.json get /v1/batches/{batch_id}/callback openapi: 3.1.0 info: title: Runflow API version: 0.1.0 description: >- Public Runflow API. Run AI image and video models, manage media, inspect run history, and configure webhooks. Auth: HTTP Bearer. This document is the customer integration surface only. Admin and internal operations plus generic system reference-data tables are intentionally omitted. servers: - url: https://api.runflow.io description: Production security: - HTTPBearer: [] tags: - name: Models description: >- Browse the model catalog and dispatch model runs. The primary surface for running AI image and video generation. - name: Runs description: >- Inspect, cancel, and re-run model executions. Fetch logs, node-runs, and callback delivery history. - name: Media description: >- Upload images and videos as inputs. Organize assets into folders. Three-step presigned upload flow for large files. - name: Batches description: >- Run a model on multiple inputs in one request. Includes per-item status and a single callback when the batch completes. - name: Evaluations description: >- Submit an image generated anywhere for automated quality evaluation, then read a pass verdict, a 0-1 score, and structured issues. No Runflow run required. - name: Webhooks description: >- Subscribe to platform events. Inspect delivery history, redeliver failed callbacks, manage signing secrets. - name: Account description: Read your account identity and credit balance. - name: Status description: Health and readiness probes for the API. paths: /v1/batches/{batch_id}/callback: get: tags: - Batches summary: Get batch callback delivery history description: Get callback delivery history for a batch (with attempts eager-loaded). operationId: getBatchCallback parameters: - name: batch_id in: path required: true schema: type: string format: uuid title: Batch Id - name: X-Organization-Id in: header required: false schema: anyOf: - type: string - type: 'null' title: X-Organization-Id responses: '200': description: Successful Response content: application/json: schema: type: array items: $ref: >- #/components/schemas/models__batch_callback_delivery__BatchCallbackDelivery__FullValidator title: >- Response Get Batch Callback Deliveries V1 Batches Batch Id Callback Get '400': description: Bad request content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' '401': description: Unauthorized content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' '403': description: >- Forbidden — inspect response body `code` for the specific reason (for example: PERMISSION_DENIED, EMAIL_NOT_VERIFIED, ORGANIZATION_MEMBERSHIP_REQUIRED, ROLE_UNRESOLVED, IMPERSONATION_READ_ONLY) content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' '404': description: Not found content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' '422': description: Validation error content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' security: - HTTPBearer: [] components: schemas: models__batch_callback_delivery__BatchCallbackDelivery__FullValidator: properties: id: anyOf: - type: string format: uuid - type: 'null' title: Id batch_id: anyOf: - type: string format: uuid - type: 'null' title: Batch Id callback_url: anyOf: - type: string - type: 'null' title: Callback Url payload_bytes: anyOf: - type: string - type: 'null' title: Payload Bytes payload: anyOf: - $ref: '#/components/schemas/BatchCallbackPayload' - type: 'null' signing_secret_id: anyOf: - type: string format: uuid - type: 'null' title: Signing Secret Id is_automatic: anyOf: - type: boolean - type: 'null' title: Is Automatic status_code: anyOf: - type: string - type: 'null' title: Status Code failure_reason_code: anyOf: - type: string - type: 'null' title: Failure Reason Code failure_detail: anyOf: - type: string - type: 'null' title: Failure Detail attempt_count: anyOf: - type: integer - type: 'null' title: Attempt Count max_attempts: anyOf: - type: integer - type: 'null' title: Max Attempts next_attempt_at: anyOf: - type: string format: date-time - type: 'null' title: Next Attempt At created_at: anyOf: - type: string format: date-time - type: 'null' title: Created At updated_at: anyOf: - type: string format: date-time - type: 'null' title: Updated At completed_at: anyOf: - type: string format: date-time - type: 'null' title: Completed At attempts: anyOf: - items: $ref: >- #/components/schemas/models__batch_callback_delivery__BatchCallbackDeliveryAttempt__FullValidator type: array - type: 'null' title: Attempts type: object title: FullValidator description: Response shape. ErrorResponse: properties: code: type: string title: Code message: type: string title: Message errors: anyOf: - items: additionalProperties: true type: object type: array - type: 'null' title: Errors type: object required: - code - message title: ErrorResponse description: Standard error envelope — matches exception handler output. BatchCallbackPayload: properties: event: $ref: '#/components/schemas/BatchCallbackEvent' description: Event type. batch_id: type: string format: uuid title: Batch Id description: The unique identifier of the batch. status: $ref: '#/components/schemas/BatchCallbackStatus' description: Terminal batch status. output: anyOf: - additionalProperties: true type: object - type: 'null' title: Output description: >- Self-describing envelope of ``{items:[{id, sequence_index, status_code, client_ref, run_id, input, output|error}], succeeded, failed, cancelled, total}``. Each item carries four correlation handles (``id`` = item handle, ``sequence_index`` = original array position, ``client_ref`` = customer-supplied label, ``run_id`` = child Run handle) plus the verbatim model-facing ``input`` fragment. ``batch.cost`` is the sum of succeeded items only. duration_ms: anyOf: - type: integer - type: 'null' title: Duration Ms description: Total batch duration in milliseconds. created_at: anyOf: - type: string format: date-time - type: 'null' title: Created At description: ISO 8601 timestamp when the batch was created. completed_at: anyOf: - type: string format: date-time - type: 'null' title: Completed At description: ISO 8601 timestamp when the batch reached terminal state. metadata: anyOf: - additionalProperties: true type: object - type: 'null' title: Metadata description: The metadata object passed at batch creation, if any. additionalProperties: false type: object required: - event - batch_id - status - output - duration_ms - created_at - completed_at - metadata title: BatchCallbackPayload description: >- JSON payload delivered to a customer's ``callback_url`` when a batch reaches a terminal state. Frozen at delivery time and stored as ``payload_bytes`` on the delivery row. Datetimes serialize via ``.isoformat()`` (``+00:00`` not ``Z``) to preserve byte-equivalence for HMAC verification on the customer side. models__batch_callback_delivery__BatchCallbackDeliveryAttempt__FullValidator: properties: id: anyOf: - type: string format: uuid - type: 'null' title: Id delivery_id: anyOf: - type: string format: uuid - type: 'null' title: Delivery Id attempt_number: anyOf: - type: integer - type: 'null' title: Attempt Number status_code: anyOf: - type: integer - type: 'null' title: Status Code response_body: anyOf: - type: string - type: 'null' title: Response Body response_time_ms: anyOf: - type: integer - type: 'null' title: Response Time Ms error_message: anyOf: - type: string - type: 'null' title: Error Message created_at: anyOf: - type: string format: date-time - type: 'null' title: Created At type: object title: FullValidator description: Response shape. BatchCallbackEvent: type: string enum: - batch.succeeded - batch.failed - batch.cancelled - batch.partial_succeeded BatchCallbackStatus: type: string enum: - succeeded - failed - cancelled - partial_succeeded securitySchemes: HTTPBearer: type: http scheme: bearer ````