List bills
AP bills with vendor, vendor reference, dates, amount and status.
MCP tool acumatica_read → list_bills
read
Lists AP bills from Bills and Adjustments. Filter by status (On Hold, Pending Approval, Balanced or Open), by vendor and by vendor reference. Use the vendor reference filter before creating a bill, to avoid entering the same vendor invoice twice.
Parameters
| Name | Type | Description |
|---|---|---|
| status enum | enum | On Hold, Pending Approval, Balanced or Open. Default: all. |
| vendor_id string | string | Only bills of this vendor. |
| vendor_ref string | string | Only bills with this vendor reference. |
| limit integer | integer | Rows per page. Default: 50. |
| cursor string | string | Next page cursor from the previous call. |
tools/call
{
"jsonrpc": "2.0",
"id": 1,
"method": "tools/call",
"params": {
"name": "acumatica_read",
"arguments": {
"operation": "list_bills",
"arguments": {}
}
}
}Example response
{
"content": [
{
"type": "text",
"text": "{ ... same JSON as structuredContent ... }"
}
],
"structuredContent": {
"bills": [
{
"reference_nbr": "004790",
"vendor_id": "V000123",
"vendor": "Northwind Office Supply",
"vendor_ref": "INV-20391",
"date": "2026-09-28",
"due_date": "2026-10-28",
"amount": 610,
"status": "Open"
}
],
"next_cursor": null
},
"isError": false
}