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",
  "data": [
    {
      "object": "purchase",
      "id": "12345",
      "url": "/v4/users/user_abc123/purchases/12345",
      "user_id": "user_abc123",
      "platform": "<string>",
      "product_id": "<string>",
      "currency": "USD",
      "price": "9.99",
      "purchased_at": "2023-11-07T05:31:56Z",
      "is_auto_renewing": true,
      "store_data": {},
      "created_at": "2023-11-07T05:31:56Z",
      "expires_at": "2023-11-07T05:31:56Z"
    }
  ],
  "has_more": true,
  "next_cursor": "<string>"
}

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. Can be repeated for multiple values (OR logic).

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

Present only when has_more is true.