Skip to main content
GET
/
users
/
{user_id}
/
purchases
List purchases for a user
curl --request GET \
  --url https://api.qonversion.io/v4/users/{user_id}/purchases \
  --header 'Authorization: Bearer <token>'
{
  "object": "list",
  "url": "/v4/users/user_abc123/purchases",
  "has_more": false,
  "next_cursor": null,
  "data": [
    {
      "object": "purchase",
      "id": "12345",
      "url": "/v4/users/user_abc123/purchases/12345",
      "user_id": "user_abc123",
      "platform": "app_store",
      "product_id": "com.example.monthly",
      "currency": "USD",
      "price": "9.99",
      "purchased_at": "2025-04-01T10:30:00Z",
      "expires_at": "2025-05-01T10:30:00Z",
      "is_auto_renewing": true,
      "store_data": {
        "transaction_id": "2000000123456789",
        "original_transaction_id": "2000000123456789",
        "product_id": "com.example.monthly"
      },
      "created_at": "2025-04-01T10:30:00Z"
    }
  ]
}

Documentation Index

Fetch the complete documentation index at: https://documentation.qonversion.io/llms.txt

Use this file to discover all available pages before exploring further.

Authorizations

​
Authorization
string
header
required

Bearer authentication using the project Secret Key (prefixed with sk_, or test_sk_ for sandbox). All v4 public endpoints require the Secret Key — see Authentication. Never expose the Secret Key in client-side code.

Path Parameters

​
user_id
string
required

The user identifier.

Maximum string length: 256

Query Parameters

​
limit
integer
default:20

Maximum number of purchases to return. Min 1, max 100.

Required range: 1 <= x <= 100
​
starting_after
string

Cursor for pagination. Pass the id of the last purchase from the previous page to fetch the next page.

​
filter[platform]
string[]

Filter purchases by platform. Repeat the query parameter to match multiple platforms (OR logic). Example: ?filter[platform]=app_store&filter[platform]=stripe.

Maximum array length: 3

Response

A paginated list of purchases.

​
object
enum<string>
required
Available options:
list
​
url
string
required
Example:

"/v4/users/user_abc123/purchases"

​
data
object[]
required
​
has_more
boolean
required
​
next_cursor
string | null

ID to pass as starting_after on the next request. Present only when has_more is true; otherwise null.