Get repository API Reference

GET

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

curl --request GET \
  --url https://api.kupe.cloud/api/v1/tenants/acme/registries/registry/repositories/team-a%252Fapi \
  --header 'Authorization: <Authorization>'

Retrieve one repository of the registry: its image count, pull count and pull reference. repository is the name without the registry and tenant, with each / sent as %2F (team-a/api is team-a%2Fapi).

Authorizations

• BearerAuth

Parameters

Path Parameters

tenant

required

string

Tenant name

name

required

string

Registry name: always registry

repository

required

string

Repository name without the registry and tenant, with each / encoded as %2F

Responses

200

Repository details

Media type application/json

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

Example

{
  "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"
}

400

Invalid name or repository

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"
}