---
title: "GET /foundation-models"
method: GET
path: "/foundation-models"
---

# GET /foundation-models

`GET /foundation-models`

Lists Amazon Bedrock foundation models that you can use. You can filter the results with the request parameters. For more information, see <a href="https://docs.aws.amazon.com/bedrock/latest/userguide/foundation-models.html">Foundation models</a> in the <a href="https://docs.aws.amazon.com/bedrock/latest/userguide/what-is-service.html">Amazon Bedrock User Guide</a>.

## Query parameters

- `byProvider` string
- `byCustomizationType` 'FINE_TUNING' | 'CONTINUED_PRE_TRAINING' | 'DISTILLATION'
- `byOutputModality` 'TEXT' | 'IMAGE' | 'EMBEDDING'
- `byInferenceType` 'ON_DEMAND' | 'PROVISIONED'

## Response `200`

Success

- ListFoundationModelsResponse
  - `modelSummaries` FoundationModelSummary[] — A list of Amazon Bedrock foundation models.
    - `modelArn` string, required — The Amazon Resource Name (ARN) of the foundation model.
    - `modelId` string, required — The model ID of the foundation model.
    - `modelName` string — The name of the model.
    - `providerName` string — The model's provider name.
    - `inputModalities` ModelModality[] — The input modalities that the model supports.
    - `outputModalities` ModelModality[] — The output modalities that the model supports.
    - `responseStreamingSupported` boolean — Indicates whether the model supports streaming.
    - `customizationsSupported` ModelCustomization[] — Whether the model supports fine-tuning or continual pre-training.
    - `inferenceTypesSupported` InferenceType[] — The inference types that the model supports.
    - `modelLifecycle` object — Contains details about whether a model version is available or deprecated.
      - `status` 'ACTIVE' | 'LEGACY', required — Specifies whether a model version is available (<code>ACTIVE</code>) or deprecated (<code>LEGACY</code>.
      - `startOfLifeTime` string, date-time — Launch time when the model first becomes available
      - `endOfLifeTime` string, date-time — Time when the model is no longer available for use
      - `legacyTime` string, date-time — Time when the model enters legacy state. Models in legacy state can still be used, but users should plan to transition to an Active model before the end of life time
      - `publicExtendedAccessTime` string, date-time — Public extended access portion of the legacy period, when users should expect higher pricing

## Other responses

- `480` — AccessDeniedException
- `481` — ValidationException
- `482` — InternalServerException
- `483` — 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)