Skip to content
Livstick Developers
v3 Request access

List containers

Method GET https://<client-api-host>/api/v3.1/containers

List the containers created through /api/v3.1 on the key's platform, newest first by default.

Authorization

Required scope containers:read

Use Authorization: Bearer liv_<prefix>_<secret>. The key must belong to a platform served by the V3 pipeline; otherwise every route answers 403 PLATFORM_NOT_V3.

Parameters

Name In Type Required Constraints Description
limit Query integer Optional min 1, max 100 Default 20
skip Query integer Optional min 0 Default 0
order Query string Optional Default -createdAt Values createdAt -createdAt

Responses

200 application/json Schema V31ContainerList

Paginated list of containers.

400 application/json Schema V31ErrorEnvelope

Invalid payload, unknown field or invalid value.

json 400 
{
  "error": {
    "code": "DATA_INVALID",
    "message": "Invalid field crid"
  }
}

401 application/json Schema V31ErrorEnvelope

Authentication failed or missing bearer token.

json 401 
{
  "error": {
    "code": "UNAUTHORIZED",
    "message": "Missing API key"
  }
}

403 application/json Schema V31ErrorEnvelope

Authenticated but not allowed: missing scope (FORBIDDEN), invalid platform constraints (INVALID_PLATFORM_CONSTRAINTS) or a platform not served by API v3.1 (PLATFORM_NOT_V3).

json 403 
{
  "error": {
    "code": "PLATFORM_NOT_V3",
    "message": "Platform is not served by API v3.1"
  }
}

429 application/json Schema V31ErrorEnvelope

Rate limit exceeded.

json 429 
{
  "error": {
    "code": "RATE_LIMITED",
    "message": "Too many requests"
  }
}

500 application/json Schema V31ErrorEnvelope

Unexpected server error.

json 500 
{
  "error": {
    "code": "INTERNAL_ERROR",
    "message": "Internal error"
  }
}