Get invoice

One invoice with all lines, amounts, payments and status.

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

read

Returns one invoice with its line items, tax rate per line, totals and the payments registered on it. A draft has status draft and no invoice number. Use it right before recording a payment to check that nothing was paid already.

Parameters

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

Request

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

Example response

JSON

{
  "invoice_id": "f2d84b1a-6c30-4e97-8a5b-1d9c7e3a40b2",
  "invoice_number": "2026-1042",
  "status": "overdue",
  "customer": "Nordlys Design AB",
  "currency": "SEK",
  "invoice_date": "2026-09-13",
  "due_date": "2026-10-13",
  "payment_reference": "2026104242",
  "lines": [
    {
      "description": "Website audit",
      "quantity": 8,
      "unit_price": 1200,
      "tax_rate": 25
    },
    {
      "description": "Hosting setup",
      "quantity": 1,
      "unit_price": 900,
      "tax_rate": 25
    }
  ],
  "total_amount": 13125,
  "total_tax": 2625,
  "paid_amount": 0,
  "payments": []
}

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.