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

# List billing transactions

`GET /account/billing/transactions`

## Request

- Base URL: `https://api.unstoppabledomains.com/partner/v3`
- URL: `https://api.unstoppabledomains.com/partner/v3/account/billing/transactions`
- Auth: HTTP bearer
- TypeScript: <https://skmtc.dev/unstoppabledomains/apis/reseller-api/docs/account/billing/transactions/get.ts> (a function with typed inputs; its response is checked against the schema)

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

## Changes

- **2026-06-03** `f2c42c8ffa95`: 2 warning, 2 info
  - removed the optional property `oneOf[#/components/schemas/BillingTransactionGroupListResponse]/next/allOf[#/components/schemas/CursorListResponseNext]/cursor` from the response with the `200` status
  - removed the optional property `oneOf[#/components/schemas/BillingTransactionListResponse]/next/allOf[#/components/schemas/CursorListResponseNext]/cursor` from the response with the `200` status
  - added the optional property `oneOf[#/components/schemas/BillingTransactionGroupListResponse]/next/allOf[#/components/schemas/CursorListResponseNext]/$cursor` to the response with the `200` status
  - added the optional property `oneOf[#/components/schemas/BillingTransactionListResponse]/next/allOf[#/components/schemas/CursorListResponseNext]/$cursor` to the response with the `200` status
- **2026-05-06** `41b2e8fef639`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/unstoppabledomains/apis/reseller-api/changes/account/billing/transactions/get.md)

---

[API](https://skmtc.dev/unstoppabledomains/apis/reseller-api.md) - [All operations](https://skmtc.dev/unstoppabledomains/apis/reseller-api/llms.txt) - [OpenAPI document](https://skmtc.dev/unstoppabledomains/apis/reseller-api/revisions/e0ac88d02fe7?raw)