Get invoice
One invoice with line items, contacts, linked payments and the email history.
MCP tool invoice_ninja_read → get_invoice
read
Returns one invoice with every line (product, description, unit cost, quantity), the contacts that receive it, the payments applied to it and the log of emails sent for it, with the recipient and time of each. Use the email log before resending, so a client is not emailed twice in a row. Totals are in the client currency.
Parameters
| Name | Type | Description |
|---|---|---|
| company string | string | Company name, for accounts with several companies. Default: the company open when you signed in. |
| invoice_number string required | string | Invoice number from list_invoices or create_invoice, e.g. INV-0038. |
tools/call
{
"jsonrpc": "2.0",
"id": 1,
"method": "tools/call",
"params": {
"name": "invoice_ninja_read",
"arguments": {
"operation": "get_invoice",
"arguments": {
"invoice_number": "invoice number"
}
}
}
}Example response
{
"content": [
{
"type": "text",
"text": "{ ... same JSON as structuredContent ... }"
}
],
"structuredContent": {
"invoice_number": "INV-0038",
"client": "Brightwave Ltd",
"status": "sent",
"invoice_date": "2026-09-01",
"due_date": "2026-09-30",
"currency": "USD",
"items": [
{
"product": "Retainer",
"description": "September web retainer, 20 hours",
"unit_cost": 90,
"quantity": 20
}
],
"amount": 1800,
"balance": 1800,
"contacts": [
"ap@brightwave.example"
],
"payments": [],
"emails": [
{
"to": "ap@brightwave.example",
"sent_at": "2026-09-01T10:15:00Z",
"template": "invoice"
}
]
},
"isError": false
}