API Reference
Referrals API endpoints
9 Referrals API endpoints for web scraping workflows, with REST paths, authentication requirements, parameters, examples, and MCP tool metadata where supported.
GET/admin/referralsadmin or apiKey1 credit/request
List referral attributions
Lists referral attributions with their reward records for support and operational review.
Params: x-api-key:header, user_id:query, status:query, campaign:query, pending_grant:query, limit:query
GET/admin/referrals/{id}admin or apiKey1 credit/request
Get referral attribution detail
Returns one referral attribution and its reward records.
Params: x-api-key:header, id:path
POST/admin/referrals/{id}/approveadmin or apiKey1 credit/request
Approve a referral held for review
Approves a review-required referral and resumes idempotent reward granting.
Params: x-api-key:header, id:path
POST/admin/referrals/{id}/rejectadmin or apiKey1 credit/request
Reject a referral held for review
Rejects a review-required referral without granting credits.
Params: x-api-key:header, id:path, request:body
POST/admin/referrals/recoveradmin or apiKey1 credit/request
Recover pending referral credit grants
Retries referral rewards whose credits were not marked as granted. Billing grants are keyed so retries do not double-credit users.
Params: x-api-key:header, limit:query
GET/admin/referrals/statsadmin or apiKey1 credit/request
Get referral funnel stats
Returns referral clicks, attributed signups, qualification, reward, cap, and review counts.
Params: x-api-key:header, from:query, to:query, campaign:query
POST/referrals/clickpublic1 credit/request
Capture a referral click
Records sanitized referral click metadata for attribution analytics.
Params: request:body
GET/referrals/mejwt1 credit/request
Get current user's referral program summary
Returns the authenticated user's referral code, share path, reward settings, aggregate stats, and recent referral records.
Params: Authorization:header
GET/referrals/me/eventsjwt1 credit/request
List current user's referral events
Returns recent referral attribution records where the authenticated user is either the referrer or referred account.
Params: Authorization:header, limit:query