list_events
Retrieve a filtered historical timeline of app installs, uninstalls, subscription changes, charges, earnings, and credits for Shopify Partner analytics.
Instructions
List the historical event timeline: installs, uninstalls, subscription changes, charges, earnings, and credits. Needs the Manage apps permission.
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_events"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| after | No | nextCursor from the previous page | |
| appId | No | App ID: the number or a gid:// ID | |
| first | No | Page size, default 100 | |
| shopId | No | Shop ID: the number or a gid:// ID | |
| eventTypes | No | EventType values, e.g. RELATIONSHIP_UNINSTALLED | |
| occurredAtMax | No | End of the window. Defaults to now; the window is at most 365 days | |
| occurredAtMin | No | Start of the window. Defaults to 30 days before the end |