List repositories API Reference

GET

/tenants/{tenant}/registries/{name}/repositories

curl --request GET \
  --url 'https://api.kupe.cloud/api/v1/tenants/acme/registries/registry/repositories?page=1&pageSize=25&search=team-a' \
  --header 'Authorization: <Authorization>'

Authorizations

• BearerAuth

Parameters

Path Parameters

tenant

required

string

Tenant name

name

required

string

Registry name: always registry

Query Parameters

page

integer

default: 1 >= 1 <= 10000

Page, from 1

pageSize

integer

default: 25 >= 1 <= 100

Repositories per page

search

string

Part of a repository name: lower-case letters, digits, ‘.’, ‘_’, ‘-’ and ‘/’

Responses

200

One page of repositories

Media type application/json

object

items

Array<object>

object

createdAt

string

imageCount

integer

name

Name is the repository’s name without the registry and tenant.

string

pullCount

PullCount is how many times its images were pulled.

integer

pullReference

PullReference is what docker pull takes, before “:” or “@”.

string

updatedAt

string

page

integer

pageSize

integer

total

Total is the number of repositories across every page.

integer

Example

{
  "items": [
    {
      "createdAt": "2026-10-21T10:00:00Z",
      "imageCount": 7,
      "name": "team-a/api",
      "pullCount": 120,
      "pullReference": "registry.kupe.cloud/acme/team-a/api",
      "updatedAt": "2026-10-21T12:30:00Z"
    }
  ],
  "page": 1,
  "pageSize": 25,
  "total": 312
}

400

Invalid name, page, pageSize or search

Media type application/json

object

code

string

error

string

field

string

message

string

severity

string

Example ^generated

{
  "code": "example",
  "error": "example",
  "field": "example",
  "message": "example",
  "severity": "example"
}

401

Missing or invalid authentication

Media type application/json

object

code

string

error

string

field

string

message

string

severity

string

Example ^generated

{
  "code": "example",
  "error": "example",
  "field": "example",
  "message": "example",
  "severity": "example"
}

403

Not a member of this tenant

Media type application/json

object

code

string

error

string

field

string

message

string

severity

string

Example ^generated

{
  "code": "example",
  "error": "example",
  "field": "example",
  "message": "example",
  "severity": "example"
}

404

Media type application/json

object

code

string

error

string

field

string

message

string

severity

string

Example ^generated

{
  "code": "example",
  "error": "example",
  "field": "example",
  "message": "example",
  "severity": "example"
}

409

The registry is not ready yet (code registry_not_ready)

Media type application/json

object

code

string

error

string

field

string

message

string

severity

string

Example ^generated

{
  "code": "example",
  "error": "example",
  "field": "example",
  "message": "example",
  "severity": "example"
}

429

Rate limit exceeded

Media type application/json

object

code

string

error

string

field

string

message

string

severity

string

Example ^generated

{
  "code": "example",
  "error": "example",
  "field": "example",
  "message": "example",
  "severity": "example"
}

503

The registry is busy or temporarily unavailable; retry

Media type application/json

object

code

string

error

string

field

string

message

string

severity

string

Example ^generated

{
  "code": "example",
  "error": "example",
  "field": "example",
  "message": "example",
  "severity": "example"
}