solicitations_getSolicitationActionsForOrder
Check which solicitation actions are available for an order.
readAmazon Seller (SP-API)sp.solicitations
(Amazon operationId: getSolicitationActionsForOrder.) Amazon SP-API · getSolicitationActionsForOrder · GET /solicitations/v1/orders/{amazonOrderId} Always call this before solicitations_createProductReviewAndSellerFeedbackSolicitation to verify the action is permitted; if no action is listed, skip the order. Amazon restricts solicitations based on order age, category, and whether a solicitation was already sent.
Call it
In an AI client (MCP)
{
"name": "solicitations_getSolicitationActionsForOrder",
"arguments": {
"store": "myStore-US",
"orderId": "<orderId>"
}
}From code (Tool API)
curl -X POST https://api.sellersheetai.com/api/v1/tools/solicitations_getSolicitationActionsForOrder \
-H "Authorization: Bearer $SELLERSHEET_API_KEY" \
-H "Content-Type: application/json" \
-d '{"store":"myStore-US","orderId":"<orderId>"}'Early access — the Tool API is open on request, contact us.
Arguments
| Name | Type | Description |
|---|---|---|
storerequired | string | the store ref `<store>-<CC>` (name-country, e.g. 'myStore-US') — one of get_user_context's store_refs, verbatim. |
orderIdrequired | string | Amazon order ID (e.g. '114-1234567-1234567'). Maps to the {amazonOrderId} path. |
marketplaceId | string | optional Amazon marketplaceId; defaults to the store ref's marketplace. |
Result
Every tool answers {notification, data, human_action}; data carries:
data.orderId— the queried order ID.data.result— HATEOAS payload. Eligible actions live under _links.actions (and _embedded.actions) — a non-empty actions list means a solicitation is permitted for this order.