> ## 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 a customer's wallet transactions > List the credit transactions across all of a customer's wallets, filtered by feature, subscription, or date range, with pagination. ## OpenAPI ````yaml GET /api/v1/credit_systems/v2/wallets/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/transactions: get: tags: - Wallets summary: List a customer's wallet transactions description: > Retrieves the credit transactions across all of a customer's wallets. 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`) A `customer_key` is required. To scope to a single wallet instead, use `GET /api/v1/credit_systems/v2/wallets/{id}/transactions`. operationId: listCustomerWalletTransactions parameters: - name: customer_key in: query required: true description: >- The unique identifier of the customer on your platform, saved as customer_key on Metrifox schema: type: string example: cust-mljp3ra6ffjm - 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: type: object properties: statusCode: type: integer example: 200 message: type: string example: Credit transactions fetched successfully meta: type: object description: Pagination metadata properties: current_page: type: integer total_pages: type: integer total_count: type: integer limit_value: type: integer description: Number of records per page next_page: type: integer nullable: true prev_page: type: integer nullable: true first_page: type: boolean last_page: type: boolean out_of_range: type: boolean data: type: array items: $ref: '#/components/schemas/CreditTransactionEntity' errors: type: object additionalProperties: true examples: wallet_transactions: summary: Wallet Transactions Response value: statusCode: 200 message: Credit transactions fetched successfully meta: current_page: 1 total_pages: 1 total_count: 3 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' - id: 5c0b9d72-1a44-4e83-9f2c-6e3a8b1d04f7 amount: 8 quantity: null event_name: overage payoff usage_event_id: null created_at: '2026-03-12T17:02:11.500Z' errors: {} '400': description: Bad request - a customer_key or wallet id is required content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' '401': description: Unauthorized - Invalid or missing API key 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/transactions?customer_key=cust-mljp3ra6ffjm&feature_key=image_generation&per_page=20" \ -H "x-api-key: your_api_key" components: schemas: CreditTransactionEntity: type: object properties: id: type: string description: Unique transaction identifier amount: type: number description: Amount of credits debited or credited in this transaction quantity: type: number nullable: true description: Quantity of the metered event that drove this transaction event_name: type: string nullable: true description: Name of the metered event that produced this transaction usage_event_id: type: string nullable: true description: ID of the usage event that produced this transaction created_at: type: string format: date-time description: When the transaction was recorded 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 ````