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

# Get Default Message

Gets the default message for a specific product in a specific locale, if it’s configured.

## URL

GET https://api.storekit.apple.com/inApps/v1/messaging/default/{productId}/{locale}

## Sandbox URL

GET https://api.storekit-sandbox.apple.com/inApps/v1/messaging/default/{productId}/{locale}

## Path Parameters

locale: The locale of the message. productId: The product identifier of the message.

## Response Codes

200 OK: Request succeeded. 400 Bad Request: The request is invalid and unacceptable. 401 Unauthorized: The JSON Web Token (JWT) in the authorization header is invalid. For more information, see Generating JSON Web Tokens for API requests. 404 Not Found: The default message for the specified product ID and locale wasn’t found. 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 Retention Messaging API changelog Setting up retention messages

## Discussion

Discussion Call this endpoint to retrieve the default message you previously configured for a specific product in a specific locale. If a default message isn’t configured, the endpoint returns an HTTP 404 error with DefaultMessageNotFoundError. For information about setting up default messages, see Setting up retention messages.

## See Also

### Default message configuration

- [Configure Default Message](retentionmessaging/configure-default-message.md)
- [Delete Default Message](retentionmessaging/delete-default-message.md)
- [DefaultConfigurationRequest](retentionmessaging/defaultconfigurationrequest.md)
- [DefaultConfigurationResponse](retentionmessaging/defaultconfigurationresponse.md)