Fetching Profiles

You can fetch real-time profile attributes and audience membership for a user using the GrowthLoop Personalization API.

Endpoint

GET https://segments.growthloop.com/v1/entities/users/user001

users → The entity name
user001 → The entity ID

Replace users and user001 with your configured entity name and user identifier.

Authentication

Authentication is handled via a Bearer Token passed in the request header.

Required Header

Authorization: Bearer YOUR_PERSONALIZATION_API_KEY

Make sure your API key has the Personalization API scope enabled.

Example Request (cURL)

curl -X GET "https://segments.growthloop.com/v1/entities/users/user001" \
  -H "Authorization: Bearer YOUR_PERSONALIZATION_API_KEY" \
  -H "Content-Type: application/json"

Sample Response

Below is an example JSON response returned by the API:

{
    "age": 30,
    "audience_count": 2,
    "audiences": {
        "1": {
            "audience_name": "chruned users",
            "offer": "20%"
        },
        "2": {
            "audience_name": "Onboarding",
            "bruh": "10%"
        }
    },
    "entity_id": "user_12345",
    "entity_name": "customers",
    "first_name": "John",
    "is_premium": true,
    "last_login": "2024-01-15T10:30:00Z",
    "last_name": "Doe",
    "metadata": {
        "campaign": "spring_2024",
        "source": "signup_form",
        "utm_source": "google"
    },
    "subscription_tier": "gold",
    "tags": [
        "vip",
        "early_adopter"
    ]
}

Response Fields Explained

Profile Attributes

Any warehouse attributes available for the user, such as:

age
first_name
last_name
subscription_tier
is_premium
last_login

These are served directly from your warehouse-backed profile.

Audience Membership

audience_count → Number of audiences the user currently qualifies for
audiences → Object containing audience names and any associated attributes

This allows you to dynamically check qualification and serve personalized experiences (e.g., win-back offers, onboarding flows, pricing changes).

Entity Information

entity_id → Unique identifier for the profile
entity_name → The entity type (e.g., customers)