---
title: "List purchases"
method: GET
path: "/v4/purchases"
tags: ["Purchases"]
---

# List purchases

`GET /v4/purchases`

Returns a cursor-paginated list of purchases recorded in the account, typically imported from e-commerce platforms. Each purchase includes its `transaction_id`, `status`, `source` (e.g. the originating platform), the buyer's `email_address` and `subscriber_id`, monetary breakdown (`subtotal`, `discount`, `tax`, `total`, `currency`), and the purchased `products`.

To record a new purchase, use [Create a purchase](/api-reference/purchases/create-a-purchase).

## Query parameters

- `after` unknown
- `before` unknown
- `include_total_count` boolean
- `per_page` unknown

## Response `200`

Returns a paginated list of all purchases for your account

- object
  - `purchases` object[], required
    - `id` integer, required
    - `transaction_id` string, required
    - `subscriber_id` integer, required
    - `status` string, required
    - `email_address` string, required — The subscriber that the purchase belongs to
    - `currency` string, required — 3 letter currency code (e.g. `USD`)
    - `transaction_time` string, required
    - `subtotal` number, float, required
    - `discount` number, float, required
    - `tax` number, float, required
    - `total` number, float, required
    - `products` object[], required — Array of purchased products
      - `quantity` integer, required — Product quantity
      - `lid` string, required — Each product should have a unique `lid` (i.e., line item identifier) for this purchase.
      - `unit_price` number, float, required — Product price
      - `sku` unknown, required
      - `name` string, required — Product name
      - `pid` string, required — This is your identifier for a product. Each product provided in the `products` array must have a unique pid. Variants of the same product should have the same pid.
    - `source` string
  - `pagination` object, required
    - `has_previous_page` boolean, required
    - `has_next_page` boolean, required
    - `start_cursor` string, required
    - `end_cursor` string, required
    - `per_page` integer, required

## Other responses

- `401` — Returns a 401 if the token and/or account cannot be authenticated

---

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