Swagger Petstore - OpenAPI 3.0
GET/containers

List containers

Lists all containers with optional filtering and pagination. Results are sorted by creation timestamp and can be ordered ascending or descending. Use limit, order, after, and name to control the results returned.

4 parameters
limitintegeroptional
Maximum number of containers to return per page. Must be between 1 and 100. Defaults to 20 when omitted.
Default:20
orderstringoptional
Sort order by creation timestamp: `asc` for ascending or `desc` for descending. Defaults to `desc` when omitted.
Allowed:ascdescDefault:desc
afterstringoptional
Pagination cursor. Pass a container ID to fetch containers created after that point in the list.
namestringoptional
Filter results to containers matching this name.

2 status codes
200Returns a paginated list of container objects with metadata including the first and last container identifiers and a flag indicating whether more containers are available.
objectstringrequired
The type of object returned, must be 'list'.
Allowed:list
dataarray<TheContainerObject>required
A list of containers.
first_idstringrequired
The ID of the first container in the list.
last_idstringrequired
The ID of the last container in the list.
has_morebooleanrequired
Whether there are more containers available.
429Returned when the request exceeds the rate limit.
errorobjectrequired

Error handling

A 429 is returned when the request exceeds the rate limit. limit must be between 1 and 100, defaulting to 20 when omitted. order must be either asc or desc, defaulting to desc. after is a cursor for pagination — pass a container ID to fetch the next page.