List invoices
How do I read my invoices?
dorna_invoices lists your invoices, newest first. Give it an invoiceId to read one invoice with its lines.
- dorna_invoices
- Read only
Parameters
| Field | Type | Description |
|---|---|---|
invoiceId | string (ID) | Returns this one invoice with its lines. |
campaignId | string (ID) | Only invoices of this campaign. |
projectId | string (ID) | Only invoices of this project. |
from | string | Start of the date range, YYYY-MM-DD. |
to | string | End of the date range, YYYY-MM-DD. |
limit | integer, 1 to 50 | How many rows to return, newest first. |
What it returns
Without invoiceId: number, type, issue date, related campaign, subtotal, discount, VAT and final amount, Donut purchased, and the paid and unpaid totals; filterable by campaign, project and date range. With invoiceId: the lines, add-ons and Donut packages. Amounts are in rials (10 rials = 1 toman).
Example
Ask your assistant: Match my June invoices with my campaigns.
The assistant then calls the tool like this:
{
"name": "dorna_invoices",
"arguments": {
"invoiceId": "64f1a2b3c4d5e6f7a8b9c0d1",
"campaignId": "64f1a2b3c4d5e6f7a8b9c0d1"
}
}A typical result looks like this (the values are examples):
{
"total": 3,
"paid": {
"count": 1,
"amountRials": 11880000
},
"unpaid": {
"count": 1,
"amountRials": 11880000
},
"invoices": [
{
"id": "64f1a2b3c4d5e6f7a8b9c0d1",
"number": "INV-1405-0042",
"kind": "purchase",
"campaignId": "64f1a2b3c4d5e6f7a8b9c0d1",
"issuedAt": "2026-11-01T09:30:00.000Z",
"subtotalRials": 12000000,
"discountRials": 1200000,
"vatRials": 1080000,
"totalRials": 11880000,
"donuts": 40
}
]
}Access and confirmation
Read only: this tool never changes anything in your account.
Related tools: dorna_list_transactions dorna_campaigns
Still have a question?
Open this guide in your own AI assistant and ask it.