Skip to main content
GET
/
customers
/
{customer_id}
Get a customer
curl --request GET \
  --url https://api.qonversion.io/v4/customers/{customer_id} \
  --header 'Authorization: Bearer <token>'
{
  "object": "customer",
  "url": "/v4/customers/customer_abc123",
  "data": {
    "customer": {
      "client_id": "customer_abc123",
      "external_identity": "user@example.com",
      "environment": 2,
      "platform": "iOS",
      "country": "US",
      "status": "active",
      "since": "2026-03-18T09:42:11Z",
      "last_seen": "2026-04-22T18:05:33Z"
    },
    "device": {
      "platform": "iOS",
      "os_version": "17.4",
      "device_model": "iPhone15,3",
      "app_version": "4.12.0",
      "sdk_version": "5.9.1"
    },
    "attributionData": [
      {
        "key": "source",
        "value": "organic"
      },
      {
        "key": "campaign",
        "value": "spring_sale"
      }
    ],
    "userProperties": [
      {
        "key": "plan_tier",
        "value": "premium"
      },
      {
        "key": "onboarding_variant",
        "value": "B"
      }
    ],
    "trackEvents": [
      {
        "event": "subscription_started",
        "at": "2026-03-18T09:42:45Z",
        "product_id": "com.example.pro.monthly",
        "revenue_usd": 9.99
      }
    ],
    "netPayments": 59.97,
    "currency": "USD",
    "conversionRate": 1,
    "canRemoveCustomer": true,
    "canEditEntitlements": true
  }
}

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

​
customer_id
string
required

Customer identifier.

Response

Customer details.

Customer object wrapped in the v4 envelope (object, url, data). The data block bundles the customer record with attribution, user properties, device info, and recent track events.