Authentication

Project Key

Used for standard API requests — retrieving users, properties, identities, entitlements, and creating purchases.

Find your Project Key in Project settings in the Qonversion dashboard.

curl --request GET \
  --url https://api.qonversion.io/v3/users/{id} \
  --header 'Authorization: Bearer PROJECT_KEY' \
  --header 'Content-Type: application/json'

All examples in this documentation use the Qonversion sample app Project Key (test_PV77YHL7qnGvsdmpTs7gimsxUvY-Znl2) for testing.

Secret Key

Used for advanced operations that modify user access — granting and revoking entitlements.

Prefixed with sk_

Found in Project settings in the Qonversion dashboard

The Secret API key should only be stored on your server. Never use your secret key in Android, iOS, or web apps.

curl --request POST \
  --url https://api.qonversion.io/v3/users/{user_id}/entitlements \
  --header 'Authorization: Bearer sk_YOUR_SECRET_KEY' \
  --header 'Content-Type: application/json' \
  --data '{"id": "plus", "expires": 1704067200}'

Endpoint	Key Required
Retrieve / Create Users	Project Key
Retrieve / Create User Properties	Project Key
Retrieve / Create Identities	Project Key
Retrieve Entitlements	Project Key
Grant Entitlement	Secret Key
Revoke Entitlement	Secret Key
Create Purchase	Project Key

Endpoint

Key Required

Retrieve / Create Users

Project Key

Retrieve / Create User Properties

Project Key

Retrieve / Create Identities

Project Key

Retrieve Entitlements

Project Key

Grant Entitlement

Secret Key

Revoke Entitlement

Secret Key

Create Purchase

Project Key

Overview

Get Started

Testing

Features

No-Code Builder

Remote Config

Experiments

Platform Resources

Stores Setup

SDK Migration Guides

AI-Ready

API Reference Guide

API Reference Guide v4

Project Key

Secret Key

Which key to use?

​Project Key

​Secret Key

​Which key to use?

Project Key

Secret Key

Which key to use?