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

# Get Batch

> Spec'd in OpenAPI now; returns 501 in v1 (see RFC 000055).



## OpenAPI

````yaml /api-reference/openapi.json get /v1/batches/{batch_id}
openapi: 3.1.0
info:
  description: |
    The Bigspin Annotation API annotates conversation transcripts with named,
    versioned annotators (for example ``universal-signals``).

    ## Authentication

    Every endpoint except ``/health`` and the docs surface requires a Bigspin
    API key sent as a bearer token:

    ```
    Authorization: Bearer bsk_...
    ```

    Requests without a valid key receive ``401``; revoked or disabled keys
    receive ``403``.

    ## Rate limits

    Requests are rate-limited per key (fixed window). When the limit is
    exceeded the API responds ``429`` with a ``Retry-After`` header. Provider
    capacity is additionally governed globally; saturation also surfaces as
    ``429`` + ``Retry-After``.

    ## Errors

    Every error response uses one envelope: ``{"error": ..., "detail": ...}``.

    The service runs on two substrates (Fargate/FastAPI and Lambda/ALBResolver)
    behind api-dev.bigspin.ai; the FastAPI edge's OpenAPI spec is canonical.
  summary: Synchronous transcript annotation over Bigspin's annotator registry.
  title: Bigspin Annotation API
  version: 0.1.0
servers:
  - description: Development
    url: https://api-dev.bigspin.ai
security: []
tags:
  - description: Unauthenticated liveness probe reporting the serving substrate.
    name: health
  - description: >-
      Synchronous transcript annotation and the public registry of available
      annotators.
    name: annotations
  - description: >-
      Asynchronous batch annotation. Spec'd in v1 but not yet implemented —
      endpoints return 501 (see RFC 000055).
    name: batches
paths:
  /v1/batches/{batch_id}:
    get:
      tags:
        - batches
      summary: Get Batch
      description: Spec'd in OpenAPI now; returns 501 in v1 (see RFC 000055).
      operationId: get_batch_v1_batches__batch_id__get
      parameters:
        - in: path
          name: batch_id
          required: true
          schema:
            title: Batch Id
            type: string
      responses:
        '422':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
          description: Validation Error
        '501':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
          description: Not implemented in v1 (see RFC 000055)
components:
  schemas:
    HTTPValidationError:
      properties:
        detail:
          items:
            $ref: '#/components/schemas/ValidationError'
          title: Detail
          type: array
      title: HTTPValidationError
      type: object
    ErrorResponse:
      description: The one error envelope for bigspin-api.
      properties:
        detail:
          title: Detail
          type: string
        error:
          title: Error
          type: string
      required:
        - error
        - detail
      title: ErrorResponse
      type: object
    ValidationError:
      properties:
        ctx:
          title: Context
          type: object
        input:
          title: Input
        loc:
          items:
            anyOf:
              - type: string
              - type: integer
          title: Location
          type: array
        msg:
          title: Message
          type: string
        type:
          title: Error Type
          type: string
      required:
        - loc
        - msg
        - type
      title: ValidationError
      type: object

````