---
title: "List billing transactions"
method: GET
path: "/account/billing/transactions"
tags: ["account"]
---

# List billing transactions

`GET /account/billing/transactions`

List billing transactions for your account. Each transaction represents a credit or debit applied to your balance (orders, refunds, settlements, grants, revenue share, etc.).

Filter by `type` to narrow results to specific balance-change categories. Pass `groupBy=operationId` to receive transactions grouped by their originating operation, with each group reporting the total amount and associated domain.

Results are paginated — use the `$cursor` parameter to retrieve subsequent pages.

## Query parameters

- `$cursor` string
- `type` BalanceChangeType[]
- `groupBy` 'operationId'

## Response `200`

List of billing transactions

- union
  - BillingTransactionListResponse
    - `@type` 'unstoppabledomains.com/partner.v3.CursorList', required
    - `items` BillingTransactionResponse[], required
      - `@type` 'unstoppabledomains.com/partner.v3.BillingTransaction', required
      - `id` string, required — Billing transaction ID
      - `type` 'ORDER' | 'ORDER_ADJUSTMENT' | 'REFUND' | 'SETTLEMENT' | 'GRANT' | 'DEBIT' | 'REV_SHARE' | 'REV_SHARE_REVOKE', required — Type of billing balance change
      - `amountUsdCents` integer, required — Transaction amount in USD cents. Negative for credits applied to the account; positive for debits charged against the account.
      - `operationId` string, required — ID of the operation that produced this transaction
      - `createdAtTimestamp` integer, required — Unix epoch timestamp (milliseconds) when the transaction was created
      - `notes` string, nullable, required — Optional notes describing the transaction
    - `next` CursorListResponseNext, required
      - `$cursor` string
  - BillingTransactionGroupListResponse
    - `@type` 'unstoppabledomains.com/partner.v3.CursorList', required
    - `items` BillingTransactionGroupResponse[], required
      - `@type` 'unstoppabledomains.com/partner.v3.BillingTransactionGroup', required
      - `operationId` string, required — ID of the operation that produced these transactions
      - `operationType` 'ADMIN_GENERIC' | 'DOMAIN_ADMIN_UPDATE' | 'DOMAIN_RENEW' | 'DOMAIN_RESTORE' | 'ACCOUNT_UPDATE' | 'DOMAIN_DNS_RECORD_CREATE' | 'DOMAIN_DNS_RECORD_UPDATE' | 'DOMAIN_DNS_RECORD_DELETE' | 'DOMAIN_DNS_RECORD_BATCH' | 'DOMAIN_DNS_SECURITY_ENABLE' | 'DOMAIN_DNS_SECURITY_DELETE' | 'DOMAIN_DNS_NAME_SERVER_UPDATE' | 'DOMAIN_HOSTING_UPDATE' | 'DOMAIN_HOSTING_DISABLE' | 'DOMAIN_TRANSFER_OUT' | 'DOMAIN_TRANSFER_OUT_TOGGLE' | 'DOMAIN_FLAGS_UPDATE' | 'DOMAIN_CONTACTS_UPDATE' | 'CONTACT_CREATE' | 'DOMAIN_SUGGESTION_CREATE' | 'DOMAIN_SUGGESTION_REFRESH' | 'DOMAIN_ADMIN_DNS_ZONE_MIGRATE' | 'LTO_INITIATE' | 'LTO_COMPLETE' | 'LTO_CANCEL' | 'DOMAIN_AUCTION_INTERNAL_PUSH', required — Type of the originating operation
      - `domain` string, nullable, required — Domain associated with the operation, if any
      - `createdAtTimestamp` integer, required — Unix epoch timestamp (milliseconds) when the operation was created
      - `totalAmountUsdCents` integer, required — Sum of all transaction amounts in USD cents for this group
      - `transactions` BillingTransactionResponse[], required
        - `@type` 'unstoppabledomains.com/partner.v3.BillingTransaction', required
        - `id` string, required — Billing transaction ID
        - `type` 'ORDER' | 'ORDER_ADJUSTMENT' | 'REFUND' | 'SETTLEMENT' | 'GRANT' | 'DEBIT' | 'REV_SHARE' | 'REV_SHARE_REVOKE', required — Type of billing balance change
        - `amountUsdCents` integer, required — Transaction amount in USD cents. Negative for credits applied to the account; positive for debits charged against the account.
        - `operationId` string, required — ID of the operation that produced this transaction
        - `createdAtTimestamp` integer, required — Unix epoch timestamp (milliseconds) when the transaction was created
        - `notes` string, nullable, required — Optional notes describing the transaction
    - `next` CursorListResponseNext, required
      - `$cursor` string

## Other responses

- `400` — Invalid request
- `401` — Authentication required
- `403` — Insufficient permissions
- `500` — Internal server error

---

[API](https://skmtc.net/unstoppabledomains/apis/reseller-api.md) · [All operations](https://skmtc.net/unstoppabledomains/apis/reseller-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/unstoppabledomains/reseller-api/revisions/e0ac88d02fe7/schema)