List payment requests
Payment requests with amount and status: pending, paid, refunded or canceled.
MCP tool podium_read → list_payment_requests
read
Lists the payment requests of the Payments page, one page at a time. Each row has the invoice number, the customer, the amount and the status. status is pending (nothing paid yet), paid, refunded (in full or in part) or canceled (the link no longer takes payment). Use it to see which requests are still open.
Parameters
| Name | Type | Description |
|---|---|---|
| location string | string | Location ID from list_locations. Needed when your account has more than one location. |
| status enum | enum | pending, paid, refunded or canceled. Default: all. |
| limit integer | integer | How many rows to return in one call. |
| cursor string | string | Next page cursor from the previous call. |
tools/call
{
"jsonrpc": "2.0",
"id": 1,
"method": "tools/call",
"params": {
"name": "podium_read",
"arguments": {
"operation": "list_payment_requests",
"arguments": {}
}
}
}Example response
{
"content": [
{
"type": "text",
"text": "{ ... same JSON as structuredContent ... }"
}
],
"structuredContent": {
"payment_requests": [
{
"payment_request_id": "pay_3c19",
"invoice_number": "INV-1042",
"customer": "Priya Nair",
"amount": 480,
"status": "pending",
"sent_at": "2026-10-21T10:12:00Z"
},
{
"payment_request_id": "pay_3b77",
"invoice_number": "INV-1038",
"customer": "Marcus Webb",
"amount": 120,
"status": "paid",
"sent_at": "2026-10-19T09:30:00Z"
}
],
"next_cursor": null
},
"isError": false
}