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

# GET /guardrails

`GET /guardrails`

Lists details about all the guardrails in an account. To list the `DRAFT` version of all your guardrails, don't specify the `guardrailIdentifier` field. To list all versions of a guardrail, specify the ARN of the guardrail in the `guardrailIdentifier` field.

You can set the maximum number of results to return in a response in the `maxResults` field. If there are more results than the number you set, the response returns a `nextToken` that you can send in another `ListGuardrails` request to see the next batch of results.

## Query parameters

- `guardrailIdentifier` string
- `maxResults` integer
- `nextToken` string

## Response `200`

Success

- ListGuardrailsResponse
  - `guardrails` GuardrailSummary[], required — A list of objects, each of which contains details about a guardrail.
    - `id` string, required — The unique identifier of the guardrail.
    - `arn` string, required — The ARN of the guardrail.
    - `status` 'CREATING' | 'UPDATING' | 'VERSIONING' | 'READY' | 'FAILED' | 'DELETING', required — The status of the guardrail.
    - `name` string, password, required — The name of the guardrail.
    - `description` string, password — A description of the guardrail.
    - `version` string, required — The version of the guardrail.
    - `createdAt` string, date-time, required — The date and time at which the guardrail was created.
    - `updatedAt` string, date-time, required — The date and time at which the guardrail was last updated.
    - `crossRegionDetails` object — Details about the system-defined guardrail profile that you're using with your guardrail, including the guardrail profile ID and Amazon Resource Name (ARN).
      - `guardrailProfileId` string — The ID of the guardrail profile that your guardrail is using. Profile availability depends on your current Amazon Web Services Region. For more information, see the <a href="https://docs.aws.amazon.com/bedrock/latest/userguide/guardrails-cross-region-support.html">Amazon Bedrock User Guide</a>.
      - `guardrailProfileArn` string — The Amazon Resource Name (ARN) of the guardrail profile that you're using with your guardrail.
  - `nextToken` string — If there are more results than were returned in the response, the response returns a <code>nextToken</code> that you can send in another <code>ListGuardrails</code> request to see the next batch of results.

## Other responses

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

---

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