Gulosa API Reference

Overview

The Gulosa API provides endpoints for managing loyalty points and referral programs in the TKM AI Agency Platform.

/loyalty

GET /points/{internal_user_id}

Get points balance for a user using their internal ID.

Parameter	Type	Required	Description
organization_id	string	Yes	Organization identifier

{
    "points": "number",
    "user_id": "string",
    "organization_id": "string",
    "last_updated": "string"
}

POST /generate-referral-qr

Generate a QR code for referring new users.

{
    "auth0_id": "string",
    "organization_id": "string"
}

{
    "success": true,
    "qr_code": "string (base64)",
    "referral_url": "string"
}

POST /process-referral

Process a new referral and award points.

{
    "referred_internal_id": "string",
    "referrer_internal_id": "string",
    "organization_id": "string"
}

{
    "success": true,
    "points_awarded": "number",
    "referral_id": "string"
}

POST /award-points/{auth0_id}

Award points for a specific action.

{
    "action_type": "string",
    "organization_id": "string"
}

{
    "success": true,
    "points_awarded": "number"
}

{
    "detail": "User points not found"
}

{
    "detail": "Error message"
}