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

# Get Message List

Gets the message identifier and state of all uploaded messages.

## URL

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

## Sandbox URL

GET https://api.storekit-sandbox.apple.com/inApps/v1/messaging/message/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 a list of all uploaded message identifiers and check their current state, messageState. note: If a message includes an image, also check the image state by calling Get Image List. The system displays retention messages with images only if both the message and the image are in an APPROVED state.

## See Also

### Message configuration

- [Upload Message](retentionmessaging/upload-message.md)
- [Delete Message](retentionmessaging/delete-message.md)
- [UploadMessageRequestBody](retentionmessaging/uploadmessagerequestbody.md)
- [UploadMessageImage](retentionmessaging/uploadmessageimage.md)
- [GetMessageListResponse](retentionmessaging/getmessagelistresponse.md)
- [GetMessageListResponseItem](retentionmessaging/getmessagelistresponseitem.md)