---
title: "GET /registries"
method: GET
path: "/registries"
---

# GET /registries

`GET /registries`

Lists all registries in the account. You can optionally filter results by status using the <code>status</code> parameter, or by authorizer type using the <code>authorizerType</code> parameter.

## Query parameters

- `maxResults` integer
- `nextToken` string
- `status` 'CREATING' | 'READY' | 'UPDATING' | 'CREATE_FAILED' | 'UPDATE_FAILED' | 'DELETING' | 'DELETE_FAILED'
- `authorizerType` 'CUSTOM_JWT' | 'AWS_IAM'

## Response `200`

Success

- ListRegistriesResponse
  - `registries` RegistrySummary[], required — The list of registry summaries. For details about the fields in each summary, see the <code>RegistrySummary</code> data type.
    - `name` string, required — The name of the registry.
    - `description` string, password — The description of the registry.
    - `registryId` string, required — The unique identifier of the registry.
    - `registryArn` string, required — The Amazon Resource Name (ARN) of the registry.
    - `authorizerType` 'CUSTOM_JWT' | 'AWS_IAM' — <p>The type of authorizer used by the registry. This controls the authorization method for the Search and Invoke APIs used by consumers.</p> <ul> <li> <p> <code>CUSTOM_JWT</code> - Authorize with a bearer token.</p> </li> <li> <p> <code>AWS_IAM</code> - Authorize with your Amazon Web Services IAM credentials.</p> </li> </ul>
    - `status` 'CREATING' | 'READY' | 'UPDATING' | 'CREATE_FAILED' | 'UPDATE_FAILED' | 'DELETING' | 'DELETE_FAILED', required — The current status of the registry. Possible values include <code>CREATING</code>, <code>READY</code>, <code>UPDATING</code>, <code>CREATE_FAILED</code>, <code>UPDATE_FAILED</code>, <code>DELETING</code>, and <code>DELETE_FAILED</code>.
    - `statusReason` string — The reason for the current status, typically set when the status is a failure state.
    - `createdAt` string, date-time, required — The timestamp when the registry was created.
    - `updatedAt` string, date-time, required — The timestamp when the registry was last updated.
  - `nextToken` string — If the total number of results is greater than the <code>maxResults</code> value provided in the request, use this token when making another request in the <code>nextToken</code> field to return the next batch of results.

## Other responses

- `480` — AccessDeniedException
- `481` — ValidationException
- `482` — ThrottlingException
- `483` — InternalServerException

---

[API](https://skmtc.net/aws/apis/bedrock-agentcore-control.md) · [All operations](https://skmtc.net/aws/apis/bedrock-agentcore-control/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/aws/bedrock-agentcore-control/versions/0ebde766792b/schema)