Developers
Ask
Sign inSign in

List invoices

How do I read my invoices?

1 min readUpdated 15 November 2026
Short answer

dorna_invoices lists your invoices, newest first. Give it an invoiceId to read one invoice with its lines.

  • dorna_invoices
  • Read only
Contents
  1. Parameters
  2. What it returns
  3. Example
  4. Access and confirmation

Parameters

FieldTypeDescription
invoiceIdstring (ID)Returns this one invoice with its lines.
campaignIdstring (ID)Only invoices of this campaign.
projectIdstring (ID)Only invoices of this project.
fromstringStart of the date range, YYYY-MM-DD.
tostringEnd of the date range, YYYY-MM-DD.
limitinteger, 1 to 50How 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.

ChatGPTClaudeGemini