Get invoice
One invoice with its lines, taxes, payments and client details.
MCP tool alegra_read → get_invoice
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
| Name | Type | Description |
|---|---|---|
| invoice_id string required | string | Invoice ID from list_invoices. |
tools/call
{
"jsonrpc": "2.0",
"id": 1,
"method": "tools/call",
"params": {
"name": "alegra_read",
"arguments": {
"operation": "get_invoice",
"arguments": {
"invoice_id": "invoice_8c41d2"
}
}
}
}Example response
{
"content": [
{
"type": "text",
"text": "{ ... same JSON as structuredContent ... }"
}
],
"structuredContent": {
"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": []
},
"isError": false
}