Get all promotions
list_promotionsRetrieve all promotions with pagination and filtering by promotion code or shop account. Supports page size up to 100.
Instructions
Rate limit: 100 requests / 10 seconds per shop. See Rate limiting.
Returns all promotions. The maximum page size is 100 - larger values are capped at 100.
Tool call template
This tool declares no required parameters. Add optional parameters from the input schema as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {},
"name": "list_promotions"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| page | No | Native page | |
| size | No | Number of elements per page. The maximum page size is 100 - larger values are capped at 100. | |
| codes | No | Filter by promotion code(s) | |
| account | No | Exact private shop profile label; not a provider identity or authorization proof. |