---
title: Get Image List
framework: retentionmessaging
role: symbol
role_heading: Web Service Endpoint
path: retentionmessaging/get-image-list
---

# Get Image List

Gets the image identifier and state for all uploaded images.

## URL

GET https://api.storekit.apple.com/inApps/v1/messaging/image/list

## Sandbox URL

GET https://api.storekit-sandbox.apple.com/inApps/v1/messaging/image/list

## Response Codes

200 OK: Request succeeded. 429 : The request exceeded the rate limit. For more information, see Identifying rate limits. 500 Internal Server Error: Server error. Try again later.

## Mentioned in

Identifying rate limits Setting up retention messages

## Discussion

Discussion Call this endpoint to get all uploaded image identifiers and check their current state, imageState. Images need to be in an APPROVED state before the system can display messages that contain them.

## See Also

### Image configuration

- [Upload Image](retentionmessaging/upload-image.md)
- [Delete Image](retentionmessaging/delete-image.md)
- [GetImageListResponse](retentionmessaging/getimagelistresponse.md)
- [GetImageListResponseItem](retentionmessaging/getimagelistresponseitem.md)