Get invoice

One invoice with its lines, taxes, payments and client details.

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

read

Returns one sales invoice with every line (item, quantity, price, tax), the totals, the payments already recorded and the client with the email Alegra holds. The numbering is shown as prefix and number. Fails with a not-found error when the invoice does not exist in your account.

Parameters

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

Request

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

Example response

JSON

{
  "invoice_id": "1038",
  "number": "FV-0038",
  "status": "open",
  "date": "2026-09-15",
  "due_date": "2026-09-30",
  "currency": "USD",
  "client": {
    "contact_id": "20",
    "name": "Northwind Studio",
    "email": "accounts@northwind.example"
  },
  "items": [
    {
      "item_id": "12",
      "name": "Landing page review",
      "quantity": 2,
      "price": 400,
      "tax": "IVA 19%"
    },
    {
      "item_id": "15",
      "name": "Setup",
      "quantity": 1,
      "price": 150,
      "tax": "IVA 19%"
    }
  ],
  "total": 1130.5,
  "total_paid": 0,
  "balance": 1130.5,
  "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.