list_invoices
The account's invoices, newest first: date, amount, refunded amount, currency, status (paid, open, void, uncollectible, refunded, partially_refunded), description (what it was for), a link to the PDF and hosted (the invoice's web page, where an open one can be paid).
List invoices · Read-only
The account's invoices, newest first: date, amount, refunded amount, currency, status (paid, open, void, uncollectible, refunded, partially_refunded), description (what it was for), a link to the PDF and hosted (the invoice's web page, where an open one can be paid). Paged: when hasMore is true, pass nextCursor as startingAfter. Account owners and billing admins only. Free.
| Connection | Account-owner URL or OAuth (not a team member URL) |
|---|
Parameters
| Parameter | Type | Required | Accepts | Description |
|---|---|---|---|---|
websiteId | string | No | any | Optional, kept for older callers: invoices belong to the account, so the list is the same for every website. |
limit | integer | No | 1–50 · default 10 | Invoices per page, a whole number from 1 to 50 (default 10). |
startingAfter | string | No | any | For the next page: the nextCursor from the previous answer. Leave empty for the newest invoices. |
Tool definition
What your assistant receives from tools/list:
{
"name": "list_invoices",
"title": "List invoices",
"annotations": {
"title": "List invoices",
"readOnlyHint": true,
"destructiveHint": false,
"idempotentHint": true,
"openWorldHint": false
},
"inputSchema": {
"type": "object",
"properties": {
"websiteId": {
"type": "string",
"description": "Optional, kept for older callers: invoices belong to the account, so the list is the same for every website."
},
"limit": {
"type": "integer",
"minimum": 1,
"maximum": 50,
"default": 10,
"description": "Invoices per page, a whole number from 1 to 50 (default 10)."
},
"startingAfter": {
"type": "string",
"description": "For the next page: the nextCursor from the previous answer. Leave empty for the newest invoices."
}
}
}
}list_open_invoices
The account invoices that are still unpaid (open or past due): amount, currency, due date, what it is for, the payment status, the PDF link and hosted (the page where it can be paid); at most 5, newest first; plus the next upcoming invoice (amount and the date the period ends), or null on a cancelled or lifetime plan.
get_auto_topup
Whether auto top-up is on: when credits run out, a pack of leads is bought automatically at your plan's price per lead, up to a monthly cap in USD.