---
title: "Get Transaction History"
method: GET
path: "/iap/transaction-history"
tags: ["Transactions"]
---

# Get Transaction History

`GET /iap/transaction-history`

Returns a paginated list of transactions for a given user, ordered by most recent first.

## Query parameters

- `user_id` string, required
- `limit` integer

## Response `200`

Transaction history

- object
  - `transactions` TransactionHistoryItem[], required
    - `id` string — Transaction ID.
    - `product_id` string — The product's reference ID.
    - `status` 'pending' | 'processing' | 'succeeded' | 'failed' | 'refunded' | 'disputed' — Transaction status.
    - `source` 'web_checkout' | 'store_kit' — Transaction source.
    - `purchased_at` string, date-time — Purchase timestamp.
    - `amount_cents` integer — Transaction amount in cents.
    - `currency` string — ISO 4217 currency code.
    - `product_name` string — Display name of the product.
    - `expires_at` string, date-time, nullable — Subscription expiry timestamp, or null.

## Other responses

- `400` — Invalid request -- missing or malformed parameters.
- `401` — Invalid or missing API key.

---

[API](https://skmtc.net/zerosettle/apis/zerosettle-iap-api.md) · [All operations](https://skmtc.net/zerosettle/apis/zerosettle-iap-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/zerosettle/zerosettle-iap-api/versions/1a7aa12f3d5e/schema)