> ## Documentation Index
> Fetch the complete documentation index at: https://docs.platform.arb.inc/llms.txt
> Use this file to discover all available pages before exploring further.

# List transaction history

> Lists transaction history for the authenticated user or organization with pagination support. Supports filtering by transaction type, case ID, and party ID.



## OpenAPI

````yaml api-reference/billing.yaml post /transactions/list
openapi: 3.0.3
info:
  title: billing
  description: >-
    The Billing Service manages billing-related operations across the platform.
    It handles all financial transactions, balance management, and SKU-based
    pricing across the platform.
  version: 1.0.0
servers:
  - url: https://billing.platform.arb.inc
security: []
tags:
  - name: /
  - name: _internal
  - name: balance
  - name: charge
  - name: checkout
  - name: pricing
  - name: skus
  - name: transactions
paths:
  /transactions/list:
    post:
      tags:
        - transactions
      summary: List transaction history
      description: >-
        Lists transaction history for the authenticated user or organization
        with pagination support. Supports filtering by transaction type, case
        ID, and party ID.
      operationId: listTransactions
      requestBody:
        required: false
        content:
          application/json:
            schema:
              type: object
              properties:
                limit:
                  type: integer
                  description: Maximum number of transactions to return (1-100)
                  example: 20
                cursor:
                  type: string
                  format: date-time
                  description: Pagination cursor from previous response
                  example: '2025-08-15T10:30:00.000Z'
                transactionType:
                  type: string
                  enum:
                    - charge
                    - credit
                    - refund
                  description: Filter by transaction type
                  example: charge
                caseID:
                  type: string
                  description: Filter by case ID (exact match, max 20 characters)
                  example: 2025-08-00292
                partyID:
                  type: string
                  description: Filter by party ID (exact match, max 20 characters)
                  example: claimant
      responses:
        '200':
          description: List of transactions with pagination
          content:
            application/json:
              schema:
                type: object
                properties:
                  transactions:
                    type: array
                    items:
                      type: object
                      properties:
                        id:
                          type: string
                          example: 7e2a8c9f-1b3d-4e6f-8a7c-9b1e3d5f7a9c
                        created:
                          type: string
                          format: date-time
                          example: '2025-08-15T14:30:00.000Z'
                        updated:
                          type: string
                          format: date-time
                          example: '2025-08-15T14:30:00.000Z'
                        balanceID:
                          type: string
                          example: a1b2c3d4-e5f6-7890-abcd-ef1234567890
                        userID:
                          type: string
                          format: uuid
                          example: 2720f109-0caf-4c62-af22-5d08c853711c
                        orgID:
                          type: string
                          format: uuid
                          example: 3840f219-1dbf-5d73-bg33-6e19d964822d
                        caseID:
                          type: string
                          example: 2025-08-00292
                        partyID:
                          type: string
                          example: claimant
                        createdBy:
                          type: string
                          example: user-2720f109-0caf-4c62-af22-5d08c853711c
                        transactionType:
                          type: string
                          example: charge
                        status:
                          type: string
                          example: completed
                        subtotalCredits:
                          type: number
                          example: 10
                        subtotalDollars:
                          type: number
                          example: 0
                        taxCredits:
                          type: number
                          example: 0.5
                        taxDollars:
                          type: number
                          example: 0
                        totalCredits:
                          type: number
                          example: 10.5
                        totalDollars:
                          type: number
                          example: 0
                        items:
                          type: array
                          items:
                            type: object
                            properties:
                              id:
                                type: string
                                example: 4f5e6d7c-8b9a-0c1d-2e3f-4a5b6c7d8e9f
                              skuID:
                                type: string
                                example: 5e8f9a7b-3c2d-4e6f-9a8c-7d6e5f4a3b2c
                              skuCode:
                                type: string
                                example: DOCUMENT_FILING
                              skuName:
                                type: string
                                example: Document Filing
                              skuDescription:
                                type: string
                                example: File a document in a case
                              quantity:
                                type: integer
                                example: 1
                              unitPriceCredits:
                                type: number
                                example: 10
                              unitPriceDollars:
                                type: number
                                example: 0
                              lineSubtotalCredits:
                                type: number
                                example: 10
                              lineSubtotalDollars:
                                type: number
                                example: 0
                  nextCursor:
                    type: string
                    format: date-time
                    example: '2025-08-14T09:15:00.000Z'
                  hasMore:
                    type: boolean
                    example: true
      security:
        - bearerAuth: []
components:
  securitySchemes:
    bearerAuth:
      type: http
      description: access token
      scheme: bearer
      bearerFormat: JWT

````