List or read bills

purchasing_list_bills · Reads only · Markdown

Supplier bills by due date, filtered by status, supplier, order or dates; or one bill in full.

Free*

*Free up to 1,000,000 reads a month for the whole account, then $0.50 per 10,000 reads.

Which supplier bills fall due before mid-November?

Your agent callspurchasing_list_billsFree*

The example business is Hansen & Voss, a restaurant-equipment wholesaler in Hamburg with 60 staff. The reply is the one the tool really gives.

With these arguments

{
  "status": "unpaid",
  "due_before": "2026-11-15"
}

What comes back

{
  "bills": [
    {
      "bill_id": "358e70a4-4d4f-4b48-b9ad-e94437014822",
      "supplier": {
        "supplier_id": 4101,
        "name": "Nordstahl Küchentechnik GmbH"
      },
      "reference": "NS-2026-1188",
      "status": "open",
      "overdue": false,
      "days_overdue": 0,
      "currency": "EUR",
      "issue_date": "2026-10-13",
      "due_date": "2026-11-12",
      "total": "462.50",
      "amount_paid": "0.00",
      "balance": "462.50",
      "order": "PO-0001"
    }
  ],
  "total": 1
}

Use it when

Someone asks what must be paid, and when.

What it does

With bill_id: that bill in full (lines, payments, its PDF link, the books entry it posted). Otherwise bills by due date, filtered by status (open, partially_paid, paid, void; unpaid means open or partly paid; overdue means unpaid and past due), supplier, order, due on or before a date, or issued from-to.

What comes back

bills: each with its bill_id, supplier, reference, status, total, balance and dates; and the total. With bill_id: that bill in full with lines, payments, PDF link and its books entry. Every reply also carries cost_usd and balance_usd.

Inputs

Name	Type	What it is
`bill_id`	string	The bill_id purchasing_create_bill returned. Exactly 36 characters.
`status`	string	One of: open,partially_paid,paid,void,unpaid,overdue.
`supplier`	integer or string	A supplier_id, or the supplier's name. 1 to 200 characters, at least 1.
`order`	string	The order_id, or the order's number like "PO-0007". 1 to 40 characters.
`due_before`	string	YYYY-MM-DD. Matches ^\d{4}-\d{2}-\d{2}$.
`from`	string	YYYY-MM-DD. Matches ^\d{4}-\d{2}-\d{2}$.
`to`	string	YYYY-MM-DD. Matches ^\d{4}-\d{2}-\d{2}$.
`limit`	integer	1 to 200. Default: 50.
`offset`	integer	At least 0. Default: 0.

The call

Over MCP, call purchasing_list_bills on https://api.conecto.chat/mcp/purchasing. Over REST:

Terminal

curl -X POST https://api.conecto.chat/v1/tools/purchasing_list_bills \
  -H "Authorization: Bearer $CONECTO_KEY" \
  -H "Content-Type: application/json" \
  -d '{"status":"unpaid","due_before":"2026-11-15"}'

When it refuses

A refused call costs nothing and says what to do next.

Code	When	What to do
`not_found`404	No bill of the business has that bill_id.	Find it with purchasing_list_bills.
`not_found`404	No purchase order has that order_id or number.	Find it with purchasing_list_orders.
`not_found`404	No supplier of the business has that supplier_id or name.	Call purchasing_list_suppliers, or add the supplier with purchasing_save_supplier.
`invalid_input`400	A date or currency is not valid.	Send dates like 2026-11-02 and currencies like EUR.

More Purchasing tools

All 25 tools

Give this to your agent.

Set up Conecto from https://conecto.chat/SKILL.md

List or read bills

An example

Use it when

What it does

What comes back

Inputs

The call

When it refuses

More Purchasing tools

Give this to your agent.