Get an invoice

Read one customer invoice with its lines, contact email and status.

GET https://cotlet.dev/api/v1/odoo/invoice

read

Returns the invoice header, every line with quantity, unit price and subtotal, the contact's email address and the payment status. Pass either invoice_id or number. A draft has no number. The call fails with a not-found error if your Odoo user cannot see the invoice.

Parameters

Parameters: get_invoice
NameTypeDescription
invoice_id integer integer Invoice ID from list_invoices.
number string string Invoice number such as INV/2026/00412, instead of invoice_id.

Request

cURL
curl https://cotlet.dev/api/v1/odoo/invoice \
  -H "Authorization: Bearer $COTLET_API_KEY"
Python
result = client.call("odoo", "get_invoice")
Node.js
const result = await cotlet.call('odoo', 'get_invoice');
CLI
cotlet call odoo get_invoice

Example response

JSON

{
  "invoice_id": 4182,
  "number": "INV/2026/00412",
  "contact": {
    "contact_id": 931,
    "name": "Northwind Studio",
    "email": "billing@northwind.example"
  },
  "status": "posted",
  "payment_status": "not_paid",
  "invoice_date": "2026-09-13",
  "due_date": "2026-09-27",
  "lines": [
    {
      "description": "Monthly retainer, September",
      "quantity": 1,
      "unit_price": 3200,
      "subtotal": 3200
    }
  ],
  "amount_untaxed": 3200,
  "amount_tax": 0,
  "amount_total": 3200,
  "amount_due": 3200,
  "currency": "EUR"
}

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.