---
title: "POST /ListImageRecipes"
method: POST
path: "/ListImageRecipes"
---

# POST /ListImageRecipes

`POST /ListImageRecipes`

Returns a list of image recipes.

## Query parameters

- `maxResults` string
- `nextToken` string

## Request body

- object
  - `owner` 'Self' | 'Shared' | 'Amazon' | 'ThirdParty' — The owner defines which image recipes you want to list. By default, this request will only show image recipes owned by your account. You can use this field to specify if you want to view image recipes owned by yourself, by Amazon, or those image recipes that have been shared with you by other customers.
  - `filters` Filter[] — <p>Use the following filters to streamline results:</p> <ul> <li> <p> <code>name</code> </p> </li> <li> <p> <code>parentImage</code> </p> </li> <li> <p> <code>platform</code> </p> </li> </ul>
    - `name` string — The name of the filter. Filter names are case-sensitive.
    - `values` FilterValue[] — The filter values. Filter values are case-sensitive.
  - `maxResults` integer — The maximum items to return in a request.
  - `nextToken` string — A token to specify where to start paginating. This is the NextToken from a previously truncated response.

## Response `200`

Success

- ListImageRecipesResponse
  - `requestId` string — The request ID that uniquely identifies this request.
  - `imageRecipeSummaryList` ImageRecipeSummary[] — The list of image pipelines.
    - `arn` string — The Amazon Resource Name (ARN) of the image recipe.
    - `name` string — The name of the image recipe.
    - `platform` 'Windows' | 'Linux' — The platform of the image recipe.
    - `owner` string — The owner of the image recipe.
    - `parentImage` string — The base image of the image recipe.
    - `dateCreated` string — The date on which this image recipe was created.
    - `tags` object — The tags of the image recipe.
  - `nextToken` string — The next token used for paginated responses. When this field isn't empty, there are additional elements that the service has'ot included in this request. Use this token with the next request to retrieve additional objects.

## Other responses

- `480` — ServiceException
- `481` — ClientException
- `482` — ServiceUnavailableException
- `483` — InvalidRequestException
- `484` — InvalidPaginationTokenException
- `485` — ForbiddenException
- `486` — CallRateLimitExceededException

---

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