get
https://api.fuul.xyz/api/v1/user-referrers
Returns the project-wide referral bridge for ingestion pipelines.
Each user_referrers row (L1 edge) is returned as one result. Level 1 is referrer_identifier /
referrer_identifier_type. Levels 2–4 are nested under referral_chain (referrer_2–referrer_4), derived by
walking the current user_referrers chain within the project. Missing upstream referrers are null. Cycles
truncate the chain.
Authentication:
- Requires API key with
service_rolescope in theAuthorizationheader:Authorization: Bearer <api_key> - The project is automatically derived from the API key's associated project
Pagination:
limitcontrols how many baseuser_referrersrows are returned per request (default 500, max 1000)after_idis a cursor on the base row UUID (user_referrer_id)countequals the number of base rows inresults
Incremental loads:
created_sincefilters base rows withcreated_at > valueupdated_sincefilters base rows withupdated_at > value- Ancestor
user_referrerschanges can alter derived L2–L4 values without updating descendantupdated_at;
periodic full backfills are recommended
Recent Requests
Log in to see full request history
| Time | Status | User Agent | |
|---|---|---|---|
Retrieving recent requests… | |||
Loading…
401Unauthorized - Missing or invalid API key
403Forbidden - API key does not have service_role scope
404Not Found - Project not found