Transaction

The account's billing history over a period.

A transaction is one movement on the account's balance: a payment in, a charge out. This operation reads them over a period, which is what an integration needs to reconcile the Navixy platform's billing against its own records.

The period is capped. A span longer than the report.max_time_span value that dealer/get_ui_config reports returns error 211.

Transaction object

API actions

API base path: /transaction.

---

Required sub-user rights: payment_create.

List transactions

post

/transaction/list

List the billing transactions of the current user over a period.

A request with an empty body reports interval as the missing parameter. That is the internal name of the field holding both dates; the public parameters are from and to.

Requires the payment_create right.

Authorizations

AuthorizationstringRequired

Either a user session hash or an API key, with the "NVX " prefix, for example "NVX 22eac1c27af4be7b9d04da2ce1af111b". Obtain a session hash from the userAuth operation, or create an API key from the API keys operations. A small number of operations accept a session hash only and reject an API key with error code 4; each says so in its description.

Body

fromstringRequired

Start of the period. Date and time.

Example: 2026-08-24 09:00:00

tostringRequired

End of the period. Date and time. Must be after from.

Example: 2026-08-24 09:00:00

limitinteger · min: 1 · max: 20000Optional

Optional. Maximum number of transactions to return. Both the default and the cap are 20000.

Responses

200

Matching transactions

application/json

successbooleanRead-onlyOptional

true if request finished successfully.

Example: true

400

Bad request. The response body carries the API-level error code in status.code. Validation failures also include an errors array naming each offending parameter.

application/json

default

Error response object

application/json

post/transaction/list

POST /v2/transaction/list HTTP/1.1
Host: api.eu.navixy.com
Authorization: YOUR_API_KEY
Content-Type: application/json
Accept: */*
Content-Length: 67

{
  "from": "2026-08-24 09:00:00",
  "to": "2026-08-24 09:00:00",
  "limit": 1
}

{
  "success": true,
  "list": [
    {
      "description": "text",
      "type": "text",
      "subtype": "text",
      "timestamp": "text",
      "user_id": 1,
      "dealer_id": 1,
      "tracker_id": 1,
      "amount": 1,
      "new_balance": 1,
      "old_balance": 1,
      "bonus_amount": 1,
      "new_bonus": 1,
      "old_bonus": 1
    }
  ]
}

Errors

These errors come in addition to the general error codes:

• 211 - Requested time span is too big, more than report.maxTimeSpan.