Referral influence ranking

GET/events/:eventId/referral-ranking

Retrieve the influence ranking (top 100) based on the event's invitation chain.

Auth	Not required

Path parameters

eventIdstringrequired

Event ID

Query parameters

rankingType'SCORE' | 'DESCENDANT_COUNT'

Ranking type. Default DESCENDANT_COUNT

periodType'DAILY' | 'WEEKLY' | 'ALL_TIME'

Period. Default ALL_TIME

date / rangestring

Period base date / range

genesisOnly'true'

Genesis inviters only

Response

Field	Type	Description
`rankingType / periodType`	string	Ranking conditions
`items`	object[]	Ranking items (rank / score / user / invite counts)
`generatedAt`	string	Generated time

curl https://api.4s.link/events/EVENT_ID/referral-ranking \
  -H "Authorization: Bearer 4s_at_..."

Example response
{
  "rankingType": "DESCENDANT_COUNT",
  "periodType": "ALL_TIME",
  "periodStartDate": "2026-01-01",
  "periodEndDate": null,
  "timezone": "Asia/Tokyo",
  "genesisOnly": false,
  "generatedAt": "2026-07-01T00:00:00.000Z",
  "items": [
    {
      "rank": 1,
      "score": 10,
      "entryId": "en1-...",
      "user": { "id": "a1b2c3d4-...", "slug": "taro", "firstName": "太郎" },
      "directInviteCount": 3,
      "indirectInviteCount": 7,
      "descendantCount": 10,
      "checkedInInviteCount": 5
    }
  ]
}