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

# List transactions for a wallet

> List the credit transactions recorded against a single wallet, filtered by feature, subscription, or date range, with pagination.



## OpenAPI

````yaml GET /api/v1/credit_systems/v2/wallets/{id}/transactions
openapi: 3.0.1
info:
  title: Metrifox API Documentation
  version: v1
  description: >-
    Welcome to Metrifox Platform's API documentation. This comprehensive API
    suite enables seamless integration with our platform, providing secure and
    efficient access to our services.
servers:
  - url: https://{defaultHost}
    variables:
      defaultHost:
        default: api.metrifox.com
security:
  - api_key: []
paths:
  /api/v1/credit_systems/v2/wallets/{id}/transactions:
    get:
      tags:
        - Wallets
      summary: List transactions for a wallet
      description: >
        Retrieves the credit transactions recorded against a single wallet. A
        transaction is a single

        debit or credit recorded against a credit allocation — for example, the
        credits drawn down by a

        metered usage event, or an overage payoff.


        Results are returned newest-first and paginated — check the `meta`
        object for pagination details.

        Use the optional filters to narrow the list:


        - `subscription_id` — only transactions tied to allocations granted by a
        specific subscription

        - `feature_key` — only transactions produced by a specific feature

        - `start_date` / `end_date` — restrict to a time window (matched on
        `created_at`)


        To span every wallet a customer owns instead of a single one, use

        `GET /api/v1/credit_systems/v2/wallets/transactions` with a
        `customer_key`.
      operationId: listWalletTransactions
      parameters:
        - name: id
          in: path
          required: true
          description: The unique wallet identifier
          schema:
            type: string
            format: uuid
          example: b7bf0d46-9f7d-4d58-9bb4-6bfb2d3e6a5c
        - name: subscription_id
          in: query
          required: false
          description: >-
            Only return transactions for allocations granted by this
            subscription
          schema:
            type: string
            format: uuid
        - name: feature_key
          in: query
          required: false
          description: Only return transactions produced by this feature
          schema:
            type: string
          example: image_generation
        - name: start_date
          in: query
          required: false
          description: >-
            Only return transactions recorded at or after this timestamp (ISO
            8601)
          schema:
            type: string
            format: date-time
          example: '2026-03-01T00:00:00Z'
        - name: end_date
          in: query
          required: false
          description: >-
            Only return transactions recorded at or before this timestamp (ISO
            8601)
          schema:
            type: string
            format: date-time
          example: '2026-03-31T23:59:59Z'
        - name: page
          in: query
          required: false
          description: The page of results to return
          schema:
            type: integer
            default: 1
        - name: per_page
          in: query
          required: false
          description: Number of records per page
          schema:
            type: integer
            default: 10
      responses:
        '200':
          description: Credit transactions fetched successfully
          content:
            application/json:
              schema:
                $ref: 4b95d0ce-3f77-4a03-9914-a61080bc5259
              examples:
                wallet_transactions:
                  summary: Wallet Transactions Response
                  value:
                    statusCode: 200
                    message: Credit transactions fetched successfully
                    meta:
                      current_page: 1
                      total_pages: 1
                      total_count: 2
                      limit_value: 10
                      next_page: null
                      prev_page: null
                      first_page: true
                      last_page: true
                      out_of_range: false
                    data:
                      - id: 9af2e7b1-8c3d-4d52-9b1a-23c7e4f60d21
                        amount: 25
                        quantity: 5
                        event_name: image_generated
                        usage_event_id: ue_01HXYZ456DEF
                        created_at: '2026-03-18T14:08:47.802Z'
                      - id: 2e8c1a4f-9b73-4f1a-bd64-58a9d7c83ef0
                        amount: 10
                        quantity: 2
                        event_name: image_generated
                        usage_event_id: ue_01HXYZ123ABC
                        created_at: '2026-03-15T09:22:03.114Z'
                    errors: {}
        '401':
          description: Unauthorized - Invalid or missing API key
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
        '404':
          description: Wallet not found
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
      x-codeSamples:
        - lang: curl
          label: cURL
          source: >
            curl -X GET
            "https://api.metrifox.com/api/v1/credit_systems/v2/wallets/b7bf0d46-9f7d-4d58-9bb4-6bfb2d3e6a5c/transactions?per_page=20"
            \
              -H "x-api-key: your_api_key"
components:
  schemas:
    ErrorResponse:
      type: object
      properties:
        message:
          type: string
          description: Error message
        errors:
          type: object
          additionalProperties: true
          description: Detailed error information
  securitySchemes:
    api_key:
      type: apiKey
      name: x-api-key
      in: header

````