billcom_list_bills
Retrieve a specific Bill.com bill by ID or fetch a bounded page of bills with pagination controls. Use it to read bill details for review or processing.
Instructions
Read one Bill.com bill by id, or one bounded page of bills.
Args: id: Exact bill id (cannot be combined with a page). start: Page offset (default 0). max: Page size, 1-100 (default 100). project_id: Authenticated Project UUID. project_ref: Exact project correlation reference. connector_account_ref: Project-bound connector account alias. idempotency_key: Stable business-action identity. effect: Required and must be read; Spring verifies it. approval_ref: Approved platform task UUID when resuming a write.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"effect": "<effect>"
},
"name": "billcom_list_bills"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| id | No | ||
| max | No | ||
| start | No | ||
| effect | Yes | ||
| project_id | No | ||
| project_ref | No | ||
| approval_ref | No | ||
| idempotency_key | No | ||
| connector_account_ref | No |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| result | Yes |