---
title: "Get Transactions"
method: GET
path: "/api/billing/transactions"
tags: ["Billing"]
---

# Get Transactions

`GET /api/billing/transactions`

Get transaction history with optional filters.

Query params:
    - limit: Max results (default 50)
    - start_date: Filter from date (ISO format: 2025-01-01)
    - end_date: Filter to date (ISO format: 2025-12-31)

## Query parameters

- `limit` integer
- `start_date` string, nullable
- `end_date` string, nullable

## Headers

- `X-API-Key` string, nullable

## Response `200`

Successful Response

- TransactionResponse
  - `success` boolean
  - `message` string, nullable
  - `data` union
    - Transaction[]
      - `id` string, required
      - `type` 'money_upload' | 'free_trial' | 'refund' | 'adjustment', required — money_upload, free_trial, refund, adjustment
      - `amount_usd` number, required — Amount in USD
      - `description` string, nullable
      - `status` 'completed' | 'pending' | 'failed' | 'refunded', required — completed, pending, failed, refunded
      - `payment_provider` string, nullable
      - `payment_id` string, nullable
      - `payment_method_type` string, nullable — card, apple_pay, google_pay, link, etc.
      - `card_brand` string, nullable — visa, mastercard, amex, etc.
      - `card_last4` string, nullable — Last 4 digits of card
      - `receipt_url` string, nullable — Stripe receipt/invoice URL
      - `created_at` string, required
    - Transaction
      - `id` string, required
      - `type` 'money_upload' | 'free_trial' | 'refund' | 'adjustment', required — money_upload, free_trial, refund, adjustment
      - `amount_usd` number, required — Amount in USD
      - `description` string, nullable
      - `status` 'completed' | 'pending' | 'failed' | 'refunded', required — completed, pending, failed, refunded
      - `payment_provider` string, nullable
      - `payment_id` string, nullable
      - `payment_method_type` string, nullable — card, apple_pay, google_pay, link, etc.
      - `card_brand` string, nullable — visa, mastercard, amex, etc.
      - `card_last4` string, nullable — Last 4 digits of card
      - `receipt_url` string, nullable — Stripe receipt/invoice URL
      - `created_at` string, required

## Other responses

- `422` — Validation Error
- `500` — Internal Server Error

---

[API](https://skmtc.net/compresr/apis/compresr-platform-api.md) · [All operations](https://skmtc.net/compresr/apis/compresr-platform-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/compresr/compresr-platform-api/revisions/93ee959dfa51/schema)