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

# List transactions

> Returns a paginated list of financial transactions for the authenticated organization, ordered newest first. Each transaction includes an itemized Merchant of Record fee breakdown when applicable.

<Info>Click the base URL in the API playground and select the **Sandbox** host for test data or the **Production** host for live data. Use credentials from the same environment.</Info>


## OpenAPI

````yaml /api-reference/openapi.json get /transaction/
openapi: 3.0.0
info:
  title: kelviq API
  version: 1.0.0
  description: >-
    API for interacting with kelviq services, derived from Python SDK
    documentation.
servers:
  - url: https://sandboxapi.kelviq.com/api/v1
    description: Sandbox — Test payments
  - url: https://api.kelviq.com/api/v1
    description: Production — Live payments
security:
  - bearerAuth: []
tags:
  - name: Products
    description: Catalog products.
  - name: Product Settings
    description: Per-product settings (currency, VPN/Tor/proxy, product URL).
  - name: Product Files
    description: Product images and downloadable assets.
  - name: Features
    description: Catalog features that can be granted as plan entitlements.
  - name: Plans
    description: Catalog plans (CRUD, publish, versions, prices).
  - name: Plan Entitlements
    description: Feature entitlements attached to a plan.
  - name: Plan Files
    description: Files attached to plans, and signed download links.
  - name: Media
    description: Generate presigned S3 upload URLs for product/plan images and files.
  - name: Partner
    description: Partner integration APIs (organization provisioning, lookup).
  - name: Charges
    description: >-
      One-time payments charged immediately against a customer's default payment
      method.
  - name: Refunds
    description: Full and partial refunds for paid orders.
  - name: Transactions
    description: >-
      Charges, refunds, disputes, and other financial movements for the
      authenticated organization.
  - name: Payment Methods
    description: Saved customer payment methods (cards, etc.).
  - name: Orders
    description: Completed and resolved orders for the authenticated organization.
  - name: Order Events
    description: Timeline events for a specific order.
  - name: Webhooks
    description: Delivery logs for webhook events sent to your configured endpoints.
  - name: Checkout Sessions
    description: Merchant-side view of checkout sessions created by customers.
  - name: Checkout Session Events
    description: Timeline events for a specific checkout session.
paths:
  /transaction/:
    get:
      tags:
        - Transactions
      summary: List transactions
      description: >-
        Returns a paginated list of financial transactions for the authenticated
        organization, ordered newest first. Each transaction includes an
        itemized Merchant of Record fee breakdown when applicable.
      operationId: listTransactions
      parameters:
        - name: search
          in: query
          required: false
          description: >-
            Search by payment-provider IDs, customer name, email or ID, product
            name, or payment method type.
          schema:
            type: string
        - name: status
          in: query
          required: false
          description: Filter by transaction status.
          schema:
            type: string
            enum:
              - success
              - failure
              - pending
        - name: start_date
          in: query
          required: false
          description: Include transactions created on or after this date.
          schema:
            type: string
            format: date
        - name: end_date
          in: query
          required: false
          description: Include transactions created on or before this date.
          schema:
            type: string
            format: date
        - name: page_size
          in: query
          required: false
          description: Number of results per page. Defaults to 10, maximum 100.
          schema:
            type: integer
            minimum: 1
            maximum: 100
        - name: page
          in: query
          required: false
          description: Page number to return.
          schema:
            type: integer
            minimum: 1
      responses:
        '200':
          description: A paginated list of transactions.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/TransactionListResponse'
        '401':
          description: Unauthorized — missing or invalid API key.
components:
  schemas:
    TransactionListResponse:
      type: object
      properties:
        count:
          type: integer
          example: 1
        next:
          type: string
          format: uri
          nullable: true
          example: null
        previous:
          type: string
          format: uri
          nullable: true
          example: null
        results:
          type: array
          items:
            $ref: '#/components/schemas/TransactionResponse'
    TransactionResponse:
      type: object
      description: A financial transaction for the authenticated organization.
      properties:
        id:
          type: string
          format: uuid
          example: 5b274952-0e54-48f6-aec6-e8a3f202b12e
        order:
          type: object
          description: The complete serialized order associated with the transaction.
          additionalProperties: true
        createdOn:
          type: string
          format: date-time
          example: '2026-07-28T10:30:00Z'
        currency:
          type: string
          example: USD
        currencySymbol:
          type: string
          example: $
        amountTotal:
          type: number
          format: decimal
          example: 100
        morFee:
          type: number
          format: decimal
          example: 4
        morFeeBreakdown:
          type: array
          description: >-
            Components used to calculate the total Merchant of Record fee. Empty
            when no Merchant of Record fee applies. A `fee_adjustment` component
            is included when the calculated fee is raised to match a
            processor-fee floor.
          items:
            $ref: '#/components/schemas/MorFeeBreakdownComponent'
          example:
            - name: fixed_fee
              percentage: null
              valueUnits: 40
              currency: USD
            - name: base_fee
              percentage: '2.9'
              valueUnits: 290
              currency: USD
            - name: subscription_fee
              percentage: '0.7'
              valueUnits: 70
              currency: USD
        collectedTax:
          type: number
          format: decimal
          example: 0
        netPayout:
          type: number
          format: decimal
          example: 96
        status:
          type: string
          enum:
            - success
            - failure
            - pending
          example: success
        transactionType:
          type: string
          enum:
            - CHARGE
            - REFUND
            - CHARGEBACK
            - CHARGEBACK_REVERSAL
            - CREDIT
            - PAYOUT
            - ADJUSTMENT
          example: CHARGE
        paymentMethodType:
          type: string
          example: card
        availableOn:
          type: string
          format: date
          nullable: true
          example: '2026-08-04'
        isSettled:
          type: boolean
          example: false
        paymentMethodName:
          type: string
          nullable: true
          example: visa
        last4:
          type: string
          nullable: true
          example: '4242'
    MorFeeBreakdownComponent:
      type: object
      description: One component of the total Merchant of Record fee.
      properties:
        name:
          type: string
          enum:
            - base_fee
            - fixed_fee
            - international_fee
            - subscription_fee
            - conversion_fee
            - fee_adjustment
          example: base_fee
        percentage:
          type: string
          nullable: true
          description: >-
            Percentage rate applied for this component. `null` for fixed fees
            and the `fee_adjustment` component.
          example: '2.9'
        valueUnits:
          type: integer
          format: int64
          description: Component amount in the transaction currency's minor unit.
          example: 290
        currency:
          type: string
          description: Three-letter ISO currency code.
          example: USD
      required:
        - name
        - percentage
        - valueUnits
        - currency
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      description: >-
        The Server API Key obtained from the kelviq application. Pass as a
        Bearer token in the Authorization header. Example: 'Authorization:
        Bearer __YOUR_API_KEY__'

````