Get invoice

One invoice with lines, taxes, total, payments and approval state.

GET https://cotlet.dev/api/v1/holded/invoices/{invoice_id}

read

Returns one invoice with its lines, tax and discount per line, the total, the payments recorded so far and whether it is approved or still a draft. An invoice can have several partial payments, and open shows what is left. Use it before recording a payment or sending a reminder.

Parameters

Parameters: get_invoice
NameTypeDescription
invoice_id string required string Invoice ID from list_invoices.

Request

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

Example response

JSON

{
  "invoice_id": "inv_7d31",
  "number": "INV-0045",
  "contact": {
    "contact_id": "c_5f2a91",
    "name": "Northwind Studio"
  },
  "draft": false,
  "items": [
    {
      "name": "Consulting",
      "description": "Landing page review, week 42",
      "units": 10,
      "price": 80,
      "tax": "VAT 21%"
    }
  ],
  "subtotal": 800,
  "tax_total": 168,
  "total": 968,
  "payments": [],
  "open": 968,
  "currency": "EUR",
  "due_date": "2026-10-14"
}

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.