---
title: "List Containers"
method: GET
path: "/containers"
tags: ["containers"]
---

# List Containers

`GET /containers`

Container list endpoint for retrieving a list of containers.

Follows the OpenAI Containers API spec:
https://platform.openai.com/docs/api-reference/containers

Example:
```bash
curl -X GET "http://localhost:4000/v1/containers?limit=20&order=desc"         -H "Authorization: Bearer sk-1234"
```

Or specify provider via header or query param:
```bash
curl -X GET "http://localhost:4000/v1/containers?custom_llm_provider=azure"         -H "Authorization: Bearer sk-1234"
```

## Query parameters

- `after` string, nullable
- `limit` integer, nullable
- `order` string, nullable

## Response `200`

Successful Response

- unknown

## Other responses

- `422` — Validation Error

## Changes

- **2026-09-18** `082b5fabd909` — 4 info
  - added the new optional `query` request parameter `after`
  - added the new optional `query` request parameter `limit`
  - added the new optional `query` request parameter `order`
  - added the non-success response with the status `422`

[Change history](https://skmtc.dev/flock/apis/litellm-api/changes/containers/get.md)

---

[API](https://skmtc.dev/flock/apis/litellm-api.md) · [All operations](https://skmtc.dev/flock/apis/litellm-api/llms.txt) · [OpenAPI document](https://skmtc.dev/flock/apis/litellm-api/revisions/b694deb1e459?raw)