---
title: "List external registries for a team."
method: GET
path: "/external_registries"
tags: ["externalRegistries"]
---

# List external registries for a team.

`GET /external_registries`

Required RBAC Policy: kots/externalregistry/list

## Response `200`

ListExternalRegistriesResponse contains the JSON external registries list

- object
  - `available_registries` ExternalRegistry[] — Available registries (only present when app_id query parameter is provided)
    - `appIds` string[]
    - `authType` string
    - `createdAt` string, date-time
    - `endpoint` string
    - `isReplicated` boolean
    - `provider` string
    - `slug` string
    - `teamId` string
    - `updatedAt` string, date-time
    - `username` string
  - `external_registries` ExternalRegistry[]
    - `appIds` string[]
    - `authType` string
    - `createdAt` string, date-time
    - `endpoint` string
    - `isReplicated` boolean
    - `provider` string
    - `slug` string
    - `teamId` string
    - `updatedAt` string, date-time
    - `username` string
  - `unavailable_registries` ExternalRegistry[] — Unavailable registries (only present when app_id query parameter is provided)
    - `appIds` string[]
    - `authType` string
    - `createdAt` string, date-time
    - `endpoint` string
    - `isReplicated` boolean
    - `provider` string
    - `slug` string
    - `teamId` string
    - `updatedAt` string, date-time
    - `username` string

## Other responses

- `400` — Returned on bad input
- `401` — Return if the caller is not authorized
- `403` — Returned if the caller does not have the needed permission
- `404` — Returned on resource not found

---

[API](https://skmtc.net/replicated/apis/vendor-api-v3.md) · [All operations](https://skmtc.net/replicated/apis/vendor-api-v3/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/replicated/vendor-api-v3/versions/6fcf9e54aba4/schema)