Get invoice

One invoice with line items, contacts, linked payments and the email history.

GET https://cotlet.dev/api/v1/invoice-ninja/invoices/{invoice_number}

read

Returns one invoice with every line (product, description, unit cost, quantity), the contacts that receive it, the payments applied to it and the log of emails sent for it, with the recipient and time of each. Use the email log before resending, so a client is not emailed twice in a row. Totals are in the client currency.

Parameters

Parameters: get_invoice
NameTypeDescription
company string string Company name, for accounts with several companies. Default: the company open when you signed in.
invoice_number string required string Invoice number from list_invoices or create_invoice, e.g. INV-0038.

Request

cURL
curl https://cotlet.dev/api/v1/invoice-ninja/invoices/invoice%20number \
  -H "Authorization: Bearer $COTLET_API_KEY"
Python
result = client.call("invoice-ninja", "get_invoice", {"invoice_number":"invoice number"})
Node.js
const result = await cotlet.call('invoice-ninja', 'get_invoice', {"invoice_number":"invoice number"});
CLI
cotlet call invoice-ninja get_invoice --data '{"invoice_number":"invoice number"}'

Example response

JSON

{
  "invoice_number": "INV-0038",
  "client": "Brightwave Ltd",
  "status": "sent",
  "invoice_date": "2026-09-01",
  "due_date": "2026-09-30",
  "currency": "USD",
  "items": [
    {
      "product": "Retainer",
      "description": "September web retainer, 20 hours",
      "unit_cost": 90,
      "quantity": 20
    }
  ],
  "amount": 1800,
  "balance": 1800,
  "contacts": [
    "ap@brightwave.example"
  ],
  "payments": [],
  "emails": [
    {
      "to": "ap@brightwave.example",
      "sent_at": "2026-09-01T10:15:00Z",
      "template": "invoice"
    }
  ]
}

Sign in once. Your agent does the rest.

Sign up and add the apps you need. Free 7-day trial with 2,000 credits, no card needed.