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

# List batches

> List your organization’s batches, newest first.



## OpenAPI

````yaml /api/openapi.json get /openai/v1/batches
openapi: 3.1.0
info:
  title: Liquid inference API
  version: 1.0.0
  description: >-
    OpenAI-compatible inference API plus native endpoints.


    **Authentication** — Every request needs an API key, sent as a bearer token:
    `Authorization: Bearer $LIQUID_API_KEY`. Create a key on the [API
    keys](https://console.liquid.ai/dashboard/api-keys) page of Liquid Console;
    it is shown once.


    **Batch uploads** — Batch input files are uploaded through a presigned URL
    from `POST /v1/files`; see the [Batch
    guide](https://docs.liquid.ai/api/guides/batch).


    **Decision models** — `POST /decisions/v1/systemone` implements TypeSafe's
    System One API for typed Choice, Score, and Noul decisions from decision
    models such as `d1.1` and `d1-ultra`.
servers:
  - url: https://api.liquid.ai
security:
  - apiKey: []
tags:
  - name: Models
  - name: Chat
  - name: Decision models
  - name: Files
  - name: Batches
  - name: Large uploads
paths:
  /openai/v1/batches:
    get:
      tags:
        - Batches
      summary: List batches
      description: List your organization’s batches, newest first.
      operationId: list-batches
      responses:
        '200':
          description: Successful response.
          content:
            application/json:
              example:
                object: list
                data:
                  - id: batch_abc123
                    object: batch
                    endpoint: /v1/chat/completions
                    input_file_id: file_abc123
                    completion_window: 24h
                    status: validating
                    created_at: 1730419200
                    expires_at: 1730505600
                    request_counts:
                      total: 0
                      completed: 0
                      failed: 0
              schema:
                type: object
                properties:
                  object:
                    type: string
                    description: Always "list".
                  data:
                    type: array
                    items: {}
                    description: The list of batch objects.
      x-codeSamples:
        - lang: curl
          label: cURL
          source: |-
            curl https://api.liquid.ai/openai/v1/batches \
              -H "Authorization: Bearer $LIQUID_API_KEY"
components:
  securitySchemes:
    apiKey:
      type: http
      scheme: bearer
      description: >-
        A Liquid API key from the [API
        keys](https://console.liquid.ai/dashboard/api-keys) page of Liquid
        Console, sent as `Authorization: Bearer $LIQUID_API_KEY`.

````

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