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

# Get apiv1billingtransactions



## OpenAPI

````yaml https://backend.aflux.ai/openapi get /api/v1/billing/transactions
openapi: 3.0.3
info:
  title: AdFlux Backend API
  version: v1
servers:
  - url: /
security: []
tags:
  - name: auth
  - name: users
  - name: uploads
  - name: projects
  - name: campaigns
  - name: placements
  - name: billing
  - name: payments
  - name: image-generations
paths:
  /api/v1/billing/transactions:
    get:
      tags:
        - billing
      operationId: billingListTransactions
      parameters:
        - in: query
          name: limit
          schema:
            type: integer
            minimum: 1
            maximum: 100
        - in: query
          name: cursor
          schema:
            type: string
        - in: query
          name: type
          description: Comma-separated list of BalanceTransactionType values to filter by.
          schema:
            type: string
      responses:
        '200':
          description: Success
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/BalanceTransactionPage'
        default:
          $ref: '#/components/responses/DefaultError'
      security:
        - Bearer: []
components:
  schemas:
    BalanceTransactionPage:
      type: object
      required:
        - items
      properties:
        items:
          type: array
          items:
            $ref: '#/components/schemas/BalanceTransaction'
        nextCursor:
          type: string
          nullable: true
    BalanceTransaction:
      type: object
      required:
        - id
        - type
        - amount
        - balanceAfter
        - referenceType
        - referenceId
        - createdAt
      properties:
        id:
          type: string
          format: uuid
        type:
          $ref: '#/components/schemas/BalanceTransactionType'
        amount:
          $ref: '#/components/schemas/MoneyAmount'
        balanceAfter:
          $ref: '#/components/schemas/MoneyAmount'
        referenceType:
          $ref: '#/components/schemas/BalanceReferenceType'
        referenceId:
          type: string
          format: uuid
        referenceName:
          type: string
          nullable: true
        description:
          type: string
          nullable: true
        createdAt:
          type: string
          format: date-time
        projectId:
          type: string
          format: uuid
          nullable: true
        projectName:
          type: string
          nullable: true
        periodStart:
          type: string
          format: date
          nullable: true
        periodEnd:
          type: string
          format: date
          nullable: true
    ErrorResponse:
      type: object
      required:
        - error
      properties:
        error:
          type: string
    BalanceTransactionType:
      type: string
      enum:
        - DEPOSIT
        - CAMPAIGN_CHARGE
        - REFUND
        - PROMO_BONUS
    MoneyAmount:
      type: string
      pattern: ^-?\d+(\.\d{1,6})?$
      example: '125.500000'
    BalanceReferenceType:
      type: string
      enum:
        - PAYMENT
        - CAMPAIGN
        - PROMO
        - MANUAL
  responses:
    DefaultError:
      description: Error
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/ErrorResponse'
  securitySchemes:
    Bearer:
      type: http
      scheme: bearer
      bearerFormat: JWT

````