List quotes and invoices

invoices_list · Reads only · Markdown

Quotes and invoices, newest first, by kind, status (also overdue, unpaid and expired), customer and issue date.

Free*

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

Which invoices haven't been paid yet?

Your agent callsinvoices_listFree*

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

{
  "kind": "invoice",
  "status": "unpaid"
}

What comes back

{
  "invoices": [
    {
      "invoice_id": "dc06a8a9-037e-4bc1-b064-c75202c55b0f",
      "kind": "invoice",
      "number": "INV-0042",
      "status": "sent",
      "currency": "EUR",
      "issue_date": "2026-10-14",
      "due_date": "2026-10-28",
      "overdue": false,
      "days_overdue": 0,
      "customer": {
        "contact_id": null,
        "company_id": null,
        "name": "Hotel Elbblick GmbH",
        "email": "lukas.meyer@hotel-elbblick.example",
        "address": "Elbchaussee 120\n22763 Hamburg",
        "tax_id": "",
        "country": null
      },
      "total": "13887.30",
      "total_formatted": "€13,887.30",
      "amount_paid": "0.00",
      "balance": "13887.30",
      "balance_formatted": "€13,887.30",
      "public_url": "https://cncto.co/i/2yjFWMMMxFslGRDgAAhem_gxc2VYoP84",
      "created_at": "2026-10-14T08:00:00+00:00",
      "sent_at": "2026-10-14T08:00:00+00:00",
      "credited": "0.00"
    }
  ],
  "count": 1,
  "total": 1,
  "today": "2026-10-14"
}

Use it when

Someone asks what is unpaid, overdue or still open.

For the totals owed, without the list, use invoices_summary.

What it does

Quotes, invoices and credit notes, newest first, filtered by kind, status (also overdue, unpaid and expired), customer and issue date. Totals and balances come with each one.

What comes back

The documents, newest first, each with its number, kind, status, customer, dates, total and balance; how many are on the page, the total, and today's date. Every reply also carries cost_usd and balance_usd.

Inputs

Name	Type	What it is
`kind`	string	One of: quote,invoice,credit_note.
`status`	string	overdue: past due with a balance. unpaid: sent invoices with a balance. expired: sent quotes past valid_until. One of: draft,sent,accepted,declined,paid,partially_paid,void,overdue,unpaid,expired.
`contact_id`	integer	At least 1.
`company_id`	integer	At least 1.
`customer`	string	Part of the customer's name or email, or of the number. Up to 200 characters.
`date_from`	string	Issued on or after (YYYY-MM-DD). Drafts have no issue date yet. Matches ^\d{4}-\d{2}-\d{2}$.
`date_to`	string	Issued on or before. Matches ^\d{4}-\d{2}-\d{2}$.
`limit`	integer	1 to 100. Default: 25.
`offset`	integer	At least 0. Default: 0.

The call

Over MCP, call invoices_list on https://api.conecto.chat/mcp/invoices. Over REST:

Terminal

curl -X POST https://api.conecto.chat/v1/tools/invoices_list \
  -H "Authorization: Bearer $CONECTO_KEY" \
  -H "Content-Type: application/json" \
  -d '{"kind":"invoice","status":"unpaid"}'

When it refuses

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

Code	When	What to do
`invalid_input`400	A date is not a real date as YYYY-MM-DD.	Send dates like 2026-10-01.

More Invoices tools

All 24 tools

Give this to your agent.

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

List quotes and invoices

An example

Use it when

What it does

What comes back

Inputs

The call

When it refuses

More Invoices tools

Give this to your agent.