---
title: "List container files"
method: GET
path: "/containers/{container_id}/files"
---

# List container files

`GET /containers/{container_id}/files`

## Request

- Base URL: `https://api.openai.com/v1`
- URL: `https://api.openai.com/v1/containers/{container_id}/files`
- Auth: HTTP bearer

List Container files

## Path parameters

- `container_id` string, required

## Query parameters

- `limit` integer
- `order` 'asc' | 'desc'
- `after` string

## Response `200`

Success

- ContainerFileListResource
  - `object` 'list', required: The type of object returned, must be 'list'.
  - `data` ContainerFileResource[], required: A list of container files.
    - `id` string, required: Unique identifier for the file.
    - `object` string, required: The type of this object (`container.file`).
    - `container_id` string, required: The container this file belongs to.
    - `created_at` integer, required: Unix timestamp (in seconds) when the file was created.
    - `bytes` integer, required: Size of the file in bytes.
    - `path` string, required: Path of the file in the container.
    - `source` string, required: Source of the file (e.g., `user`, `assistant`).
  - `first_id` string, required: The ID of the first file in the list.
  - `last_id` string, required: The ID of the last file in the list.
  - `has_more` boolean, required: Whether there are more files available.

## Other responses

- `404`: The container was not found or has expired, or the file specified by `after` was not found.
- `429`: The request was rejected because a rate limit was exceeded.

## Changes

- **2026-10-06** `487892d3954e`: 2 info
  - added the optional property `error/misalignment/review_target` to the response with the `404` status
  - added the optional property `error/misalignment/review_target` to the response with the `429` status
- **2026-10-05** `7f654af7f94f`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/omnistack-sh/apis/openai-api/changes/containers/:container_id/files/get.md)

---

[API](https://skmtc.dev/omnistack-sh/apis/openai-api.md) - [All operations](https://skmtc.dev/omnistack-sh/apis/openai-api/llms.txt) - [OpenAPI document](https://skmtc.dev/omnistack-sh/apis/openai-api/revisions/0a26f104d35f?raw)