List credit history
/credits/entries/read Read: looks, changes nothing. Scopes
Every change to the balances you can see, newest first, a page at a time: lines bought, extended and refunded, credits given, added and removed.
Query parameters
accountstring (uuid)Only this account's rows (a reseller you can see).
actorstring (uuid)Only what this account did.
date_fromstringA date (
2026-11-01, the whole day) or a date-time.date_tostringA date (the whole day included) or a date-time.
kindstringComma-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.
orderingstringWhich field to use when ordering the results.
pageintegerA page number within the paginated result set.
page_sizeintegerNumber of results to return per page.
scopestringsubtree: your rows and those of every reseller below you. Default: yours only (everyone's for an account that sees all credits).One of:
"subtree"searchstringMatches names, the package, the reason and the reference.
typestringWhy an operator added or removed credits.
One of:
"correction""other""payment""promo""refund"
Response
200 OK
countintegerrequiredHow many there are in all, on every page.
nextstring (uri)can be nullThe next page, or null on the last one.
previousstring (uri)can be nullThe page before, or null on the first one.
resultsobject[]requiredidintegerrequiredread-onlycreated_atstring (date-time)requiredread-onlyaccountobjectrequiredread-onlycan be nullidstring (uuid)requiredusernamestringrequired
account_namestringrequiredread-onlyamountstring (decimal)requiredread-onlybalance_afterstring (decimal)requiredread-onlykindstringrequiredread-onlykind_labelstringrequiredread-onlytypestringrequiredread-onlytype_labelstringrequiredread-onlydescriptionstringrequiredread-onlyactor_namestringrequiredread-onlyby_mebooleanrequiredread-onlycan be nullcounterparty_namestringrequiredread-onlylineobjectrequiredread-onlycan be nullidstring (uuid)requiredusernamestringrequired
line_namestringrequiredread-onlypackage_namestringrequiredread-onlydurationstringrequiredread-onlyexpires_atstring (date-time)requiredread-onlycan be nullreasonstringrequiredread-onlyreferencestringrequiredread-only
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.