> ## 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.

# Retrieve file

> Fetch metadata for a single file.



## OpenAPI

````yaml /api/openapi.json get /openai/v1/files/{id}
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/files/{id}:
    get:
      tags:
        - Files
      summary: Retrieve file
      description: Fetch metadata for a single file.
      operationId: retrieve-file
      parameters:
        - name: id
          in: path
          required: true
          description: The file id.
          schema:
            type: string
            example: file_abc123
      responses:
        '200':
          description: Successful response.
          content:
            application/json:
              example:
                id: file_abc123
                object: file
                bytes: 137587646
                created_at: 1730419200
                filename: batch_input.jsonl
                purpose: batch
                status: processed
              schema:
                type: object
                properties:
                  id:
                    type: string
                    description: The file id, referenced when creating a batch.
                  object:
                    type: string
                    description: Always "file".
                  bytes:
                    type: integer
                    description: Size of the file in bytes.
                  created_at:
                    type: integer
                    description: Unix timestamp (seconds) of creation.
                  filename:
                    type: string
                    description: The name the file was uploaded with.
                  purpose:
                    type: string
                    description: >-
                      Either "batch" (an input) or "batch_output" (a generated
                      result/error file).
                  status:
                    type: string
                    description: Always "processed"; stored files are ready.
                  expires_at:
                    type: integer
                    description: Unix timestamp (seconds) when the file expires, if set.
      x-codeSamples:
        - lang: curl
          label: cURL
          source: |-
            curl https://api.liquid.ai/openai/v1/files/file_abc123 \
              -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.