---
title: "Gets a list of all files owned by the Azure OpenAI resource. These include user uploaded content like files with purpose \"fine-tune\" for training or validation of fine-tunes models as well as files that are generated by the service such as \"fine-tune-results\" which contains various metrics for the corresponding fine-tune job."
method: GET
path: "/files"
tags: ["Files:"]
---

# Gets a list of all files owned by the Azure OpenAI resource. These include user uploaded content like files with purpose "fine-tune" for training or validation of fine-tunes models as well as files that are generated by the service such as "fine-tune-results" which contains various metrics for the corresponding fine-tune job.

`GET /files`

## Query parameters

- `purpose` 'fine-tune' | 'fine-tune-results' | 'assistants' | 'assistants_output' | 'batch' | 'batch_output' | 'evals' | 'evals_output'
- `limit` integer
- `after` string
- `order` string
- `api-version` string, required

## Response `200`

Success

- FileList — Represents a list of files.
  - `object` 'list' | 'fine_tuning.job' | 'file' | 'fine_tuning.job.event' | 'fine_tuning.job.checkpoint' | 'model' | 'upload' | 'upload.part' | 'batch' | 'wandb' — Defines the type of an object.
  - `data` File[] — The list of items.
    - `object` 'list' | 'fine_tuning.job' | 'file' | 'fine_tuning.job.event' | 'fine_tuning.job.checkpoint' | 'model' | 'upload' | 'upload.part' | 'batch' | 'wandb' — Defines the type of an object.
    - `created_at` integer — A timestamp when this job or item was created (in unix epochs).
    - `id` string — The identity of this item.
    - `status` 'uploaded' | 'pending' | 'running' | 'processed' | 'error' | 'deleting' | 'deleted' — The state of a file.
    - `bytes` integer — The size of this file when available (can be null). File sizes larger than 2^53-1 are not supported to ensure compatibility with JavaScript integers.
    - `purpose` 'fine-tune' | 'fine-tune-results' | 'assistants' | 'assistants_output' | 'batch' | 'batch_output' | 'evals' | 'evals_output', required — The intended purpose of the uploaded documents. Use "fine-tune" for fine-tuning. This allows us to validate the format of the uploaded file.
    - `filename` string, required — The name of the file.
    - `expires_at` integer — A unix timestamp (the number of seconds that have elapsed since January 1, 1970) when the file is expired.
    - `status_details` string — The error message with details in case processing of this file failed. Deprecated.

## Other responses

- `default` — An error occurred.

## Changes

- **2026-07-13** (2022-03-01-preview) `b177dc430e39` — 2 info
  - added the media type `application/json` for the response with the status `200`
  - added the media type `application/json` for the response with the status `default`
- **2026-07-13** (2022-03-01-preview) `62a50a8e2679` — 1 info
  - added the new optional `query` request parameter `purpose`
- **2022-07-22** (2022-03-01-preview) `9d525b5caa31` — 2 breaking, 4 warning
  - removed the media type `application/json` for the response with the status `200`
  - removed the media type `application/json` for the response with the status `default`
  - deleted the `query` request parameter `after`
  - deleted the `query` request parameter `limit`
  - …2 more

[Change history](https://skmtc.dev/azure/apis/cognitiveservices-azureopenai-authoring/changes/files/get.md)

---

[API](https://skmtc.dev/azure/apis/cognitiveservices-azureopenai-authoring.md) · [All operations](https://skmtc.dev/azure/apis/cognitiveservices-azureopenai-authoring/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/azure/cognitiveservices-azureopenai-authoring/revisions/b177dc430e39/schema)