---
title: "Returns a list of files."
method: GET
path: "/openai/v1/files"
tags: ["Files"]
---

# Returns a list of files.

`GET /openai/v1/files`

## Response `200`

OK

- ListFilesResponse
  - `object` 'list', required
  - `data` File[], required
    - `id` string — The file identifier, which can be referenced in the API endpoints.
    - `bytes` integer — The size of the file, in bytes.
    - `created_at` integer — The Unix timestamp (in seconds) for when the file was created.
    - `filename` string — The name of the file.
    - `object` 'file' — The object type, which is always `file`.
    - `purpose` 'batch' | 'batch_output' — The intended purpose of the file. Supported values are `batch`, and `batch_output`.

## Changes

- **2025-01-29** `c5b2589925cd` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/groq/apis/groqcloud-api/changes/openai/v1/files/get.md)

---

[API](https://skmtc.dev/groq/apis/groqcloud-api.md) · [All operations](https://skmtc.dev/groq/apis/groqcloud-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/groq/groqcloud-api/revisions/ea91f46f212a/schema)