# List 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.

Endpoint: GET /account/billing/transactions
Version: 1.0.0
Security: bearer

## Query parameters:

  - `$cursor` (string)
    Opaque cursor for paginating through results. Use the value from next.cursor in a previous response.

  - `type` (array)
    Filter transactions by type. Repeat the parameter or pass a comma-separated list to filter on multiple types.
    Enum: "ORDER", "ORDER_ADJUSTMENT", "REFUND", "SETTLEMENT", "GRANT", "DEBIT", "REV_SHARE", "REV_SHARE_REVOKE"

  - `groupBy` (string)
    When set to operationId, transactions are grouped by their originating operation and returned as BillingTransactionGroup items.
    Enum: "operationId"

## Response 400 fields (application/json):

  - `code` (string, required)
    Machine-readable error code
    Example: "VALIDATION"

  - `message` (string)
    Human-readable error description

  - `errors` (array)
    Individual errors when code is MULTIPLE_ERRORS

  - `errors.code` (string, required)

  - `errors.message` (string)

## Response 401 fields (application/json):

  - `code` (string, required)
    Machine-readable error code
    Example: "VALIDATION"

  - `message` (string)
    Human-readable error description

  - `errors` (array)
    Individual errors when code is MULTIPLE_ERRORS

  - `errors.code` (string, required)

  - `errors.message` (string)

## Response 403 fields (application/json):

  - `code` (string, required)
    Machine-readable error code
    Example: "VALIDATION"

  - `message` (string)
    Human-readable error description

  - `errors` (array)
    Individual errors when code is MULTIPLE_ERRORS

  - `errors.code` (string, required)

  - `errors.message` (string)

## Response 500 fields (application/json):

  - `code` (string, required)
    Machine-readable error code
    Example: "VALIDATION"

  - `message` (string)
    Human-readable error description

  - `errors` (array)
    Individual errors when code is MULTIPLE_ERRORS

  - `errors.code` (string, required)

  - `errors.message` (string)