> ## Documentation Index
> Fetch the complete documentation index at: https://docs.tacetai.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Get a batch

> Check a job's status and progress.



## OpenAPI

````yaml /openapi.yaml get /v1/batches/{id}
openapi: 3.1.0
info:
  title: Tacet API
  version: 2026-10
  description: |
    Send a state and typed questions; get calibrated probabilities back as JSON.
    Every answer is one of the options you listed, with a probability for each.
servers:
  - url: https://api.tacetai.com
security:
  - bearerAuth: []
tags:
  - name: Decide
    description: Answer questions about one state, synchronously.
  - name: Batches
    description: >-
      Answer the same questions for a large JSONL file of records,
      asynchronously.
paths:
  /v1/batches/{id}:
    get:
      tags:
        - Batches
      summary: Get a batch
      description: Check a job's status and progress.
      operationId: getBatch
      parameters:
        - $ref: '#/components/parameters/BatchId'
      responses:
        '200':
          description: The job.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Batch'
        '401':
          $ref: '#/components/responses/InvalidKey'
        '404':
          $ref: '#/components/responses/NotFound'
      x-codeSamples:
        - lang: python
          label: Python
          source: |
            job = client.batches.get("batch_3k9x2m")
            print(job.status, job.progress.completed, "/", job.progress.total)
        - lang: typescript
          label: TypeScript
          source: >
            const job = await client.batches.get("batch_3k9x2m");

            console.log(job.status, job.progress.completed, "/",
            job.progress.total);
        - lang: bash
          label: curl
          source: |
            curl https://api.tacetai.com/v1/batches/batch_3k9x2m \
              -H "Authorization: Bearer $TACET_API_KEY"
components:
  parameters:
    BatchId:
      name: id
      in: path
      required: true
      description: The batch id returned when the job was created.
      schema:
        type: string
        example: batch_3k9x2m
  schemas:
    Batch:
      type: object
      required:
        - id
        - model
        - status
        - progress
        - created_at
      properties:
        id:
          type: string
          example: batch_3k9x2m
        model:
          type: string
        status:
          type: string
          enum:
            - queued
            - running
            - completed
            - failed
            - cancelling
            - cancelled
        progress:
          type: object
          properties:
            total:
              type: integer
            completed:
              type: integer
            failed:
              type: integer
        created_at:
          type: string
          format: date-time
        completed_at:
          type:
            - string
            - 'null'
          format: date-time
    Error:
      type: object
      required:
        - code
        - message
      properties:
        code:
          type: string
          enum:
            - invalid_question
            - invalid_key
            - state_too_long
            - rate_limited
            - not_found
            - server_error
        message:
          type: string
  responses:
    InvalidKey:
      description: '`invalid_key`: check the Authorization header.'
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/Error'
    NotFound:
      description: '`not_found`: no batch with that id.'
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/Error'
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      description: >-
        Create a key in the Tacet console. Keep it on your server; never ship it
        in a browser or app.

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.