List billing activity
GET /api/v2/billing/activity
Lists money moving on the account. kind=transaction (the default) lists invoice payments, refunds and roundings, 10 rows per page. A refund to account credit shows as a refund row plus a credit_added row. kind=credit lists account credit movements, 25 rows per page. Every row has a stable kind to label it by. Transaction rows carry a machine method (such as card or accountCredit) and a display methodLabel. Amounts are in major units of each row’s currencyCode. Ask for the next page with page while hasMore is true.
Authentication: An API key with the scope read:billing. About keys and scopes
Request
Query parameters
kindstringtransaction for payments, refunds and roundings. credit for account credit movements. Default transaction. One of transaction, credit. Default "transaction".pageintegerPage number, starting at 0. Default 0. Pages hold 10 transaction rows or 25 credit rows. Default
0. 0 to 1000.Example
curl "https://cloud.hostup.se/api/v2/billing/activity" \ -H "Authorization: Bearer $HOSTUP_API_KEY"Responses
200 One page of billing activity.
{ "kind": "transaction", "entries": [ { "id": "txn_01hxa3b4c5d6e7f8g9h0j1k2m3", "kind": "payment", "status": "settled", "description": "Payment for invoice 202600012", "method": "card", "methodLabel": "Card payment", "amount": 249, "currencyCode": "SEK", "createdAt": "2026-10-28T09:47:47.000Z", "invoiceId": "inv_01hxa3b4c5d6e7f8g9h0j1k2m3", "invoiceNumber": "202600012" }, { "id": "txn_01hxa3b4c5d6e7f8g9h0j1k2m4", "kind": "rounding", "status": "settled", "description": "Rounding of invoice 202600011", "method": "rounding", "methodLabel": "Rounding", "amount": 0.03, "currencyCode": "SEK", "createdAt": "2026-09-30T18:35:02.000Z", "invoiceId": "inv_01hxa3b4c5d6e7f8g9h0j1k2m4", "invoiceNumber": "202600011" }, { "id": "txn_01hxa3b4c5d6e7f8g9h0j1k2m5", "kind": "refund", "status": "settled", "refundedTo": "accountCredit", "description": "Refund for invoice 202600010", "method": "accountCredit", "methodLabel": "Account credit", "amount": -211.22, "currencyCode": "SEK", "createdAt": "2026-09-28T22:52:51.000Z", "invoiceId": "inv_01hxa3b4c5d6e7f8g9h0j1k2m5", "invoiceNumber": "202600010" }, { "id": "txn_01hxa3b4c5d6e7f8g9h0j1k2m6", "kind": "credit_added", "status": "settled", "description": "Refund added to account credit", "method": "accountCredit", "methodLabel": "Account credit", "amount": 211.22, "currencyCode": "SEK", "createdAt": "2026-09-28T22:52:51.000Z", "invoiceId": null, "invoiceNumber": null } ], "hasMore": false}{ "kind": "credit", "entries": [ { "id": "cred_01hxa3b4c5d6e7f8g9h0j1k2m3", "kind": "refund", "description": "Refunded to account credit", "rawDescription": "Refunded to account credit", "amount": 211.22, "balanceAfter": 211.22, "currencyCode": "SEK", "createdAt": "2026-09-28T22:52:51.000Z", "invoiceId": "inv_01hxa3b4c5d6e7f8g9h0j1k2m5", "invoiceNumber": "202600010" } ], "hasMore": false}Response fields
kindstringOne of
transaction.entriesarray of objectidstringkindstringWhat the row is.
payment: money received for an invoice. refund: money returned (see refundedTo). credit_added: money put on the account balance, for example a refund moved to account credit. rounding: a remainder under 1 SEK that Hostup wrote off so the invoice counts as paid. It is not money the customer paid. other: anything else. Label rows by kind, not by the amount or the text. One of payment, refund, credit_added, rounding, other.statusstringsettled, refunded (a payment that was later returned; the matching refund row says where it went), pending, failed, cancelled or unknown. One of settled, refunded, pending, failed, cancelled, unknown.refundedTostringRefund rows only.
accountCredit: the money is on the account balance and pays the next invoice automatically. paymentMethod: returned to the payment method. unknown: not recorded. Absent on other rows. One of accountCredit, paymentMethod, unknown.descriptionstring or nullmethodstring or nullThe payment method, as a fixed value. Card checkout and wallets are all
card. One of card, accountCredit, swish, bankgiro, sepa, alipay, crypto, paypal, invoice, rounding, other.methodLabelstring or nullThe name of the payment method, to show.
amountnumberThe amount in the currency’s main unit, with a sign. Money in is positive. Refunds and other money out may be negative.
currencyCodestringcreatedAtstring or nullinvoiceIdstring or nullinvoiceNumberstring or nullhasMorebooleanErrors
Errors are Problem Details with a stable code. Branch on the code, not on the text.
| 400 | kind must be transaction or credit. page must be a number from 0 to 1000. |
| 401 | Unauthorized. Authentication is required. |
| 403 | Forbidden. The caller lacks a required scope or does not own the resource. |
| 404 | Not found. The resource does not exist or is not owned by the caller. |
| 429 | Rate limited. Retry after the limit resets. 429 responses include Retry-After seconds plus X-RateLimit-* headers. |
| 500 | Internal error. Retry later or contact support if the issue persists. |