minimusdocs
Help center

Credits

Get credit history totals

GET/credits/totals/

read Read: looks, changes nothing. Scopes

What the history rows the same filters select add up to, by kind, and what the accounts they cover hold now.

Query parameters

  • accountstring (uuid)

    Only this account's rows (a reseller you can see).

  • actorstring (uuid)

    Only what this account did.

  • date_fromstring

    A date (2026-11-01, the whole day) or a date-time.

  • date_tostring

    A date (the whole day included) or a date-time.

  • kindstring

    Comma-separated kinds: adjust, line_new, line_extend, line_trial, refund, transfer_out, transfer_in, returned, written_off, import.

  • linestring (uuid)

    Only rows about this line.

  • scopestring

    subtree: your rows and those of every reseller below you. Default: yours only (everyone's for an account that sees all credits).

    One of: "subtree"

  • searchstring

    Matches names, the package, the reason and the reference.

  • typestring

    Why an operator added or removed credits.

    One of: "correction" "other" "payment" "promo" "refund"

Response

200 OK

  • addedstring (decimal)required

    Added by operators, and balances brought from another panel.

  • spentstring (decimal)required

    Spent on lines.

  • refundedstring (decimal)required

    Given back for deleted lines.

  • givenstring (decimal)required

    Given to other resellers.

  • receivedstring (decimal)required

    Received from other resellers.

  • returnedstring (decimal)required

    Returned from deleted resellers' balances.

  • written_offstring (decimal)required

    Written off with deleted resellers' balances.

  • held_by_resellersstring (decimal)required

    What the accounts covered hold right now.

Errors

  • 401 No credential, or one that is wrong, expired or revoked.
  • 403 The account, or the key's or app's scopes, may not do this.
  • 429 Slow down: wait the seconds in the Retry-After header, then try again.

What each error means