Docs menu

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

Back to docs