Developers
Ask
Sign inSign in

List transactions

Where did my credit go?

1 min readUpdated 15 November 2026
Short answer

dorna_list_transactions lists your financial transactions, newest first: the credit ledger, or payments and top-ups.

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

Parameters

FieldTypeDescription
kindstringcredit (default) is the credit ledger; payment lists payments and top-ups.
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

With kind set to credit (the default): each debit and credit with its amount (negative means debit), the balance after it, the related section (campaign, order, Donut and so on) and a description. With payment: payments and top-ups through the gateway or card transfer, with status and payment date. Amounts are in rials (10 rials = 1 toman).

Example

Ask your assistant: Explain every credit change in October.

The assistant then calls the tool like this:

{
  "name": "dorna_list_transactions",
  "arguments": {
    "kind": "credit",
    "from": "2026-10-01"
  }
}

A typical result looks like this (the values are examples):

{
  "kind": "credit",
  "total": 2,
  "transactions": [
    {
      "amountRials": -11880000,
      "balanceAfterRials": 13120000,
      "section": "campaign",
      "description": "Payment of campaign Launch",
      "createdAt": "2026-11-02T10:00:00.000Z"
    },
    {
      "amountRials": 25000000,
      "balanceAfterRials": 25000000,
      "section": "topup",
      "description": "Top-up",
      "createdAt": "2026-11-01T09:30:00.000Z"
    }
  ]
}

Access and confirmation

Read only: this tool never changes anything in your account.

Related tools: dorna_get_account dorna_invoices

Still have a question?

Open this guide in your own AI assistant and ask it.

ChatGPTClaudeGemini