Referral descendants (invite tree)

GET/events/:eventId/entries/:entryId/referral-descendants

Expand the invite tree downward from the given entry as root. Each node's direct children are paginated by childrenLimit + cursor and include a total child count (CONFIRMED / CHECKED_IN only). Returns 403 unless the caller is a confirmed participant.

Auth	Login required

Path parameters

eventIdstringrequired

Event ID.

entryIdstringrequired

Root entry ID.

Query parameters

generationsnumberoptional

Depth to expand downward. Default 10 (clamped 1–50)

childrenLimitnumberoptional

Max direct children returned per node. Default 20 (clamped 1–100)

cursorstringoptional

Opaque cursor to continue a child list (invalid returns 400)

Response

Field	Type	Description
`entryId`	string	Root entry ID.
`entry`	ReferralEntry	The root node; descendants are nested under children.

Request

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

Example response

{
  "entryId": "550e8400-...",
  "entry": {
    "id": "550e8400-...",
    "invitedByEntryId": null,
    "invitationGeneration": null,
    "invitationRootEntryId": null,
    "user": { "id": "9b2c3d4e-...", "slug": "alice-yamada", "firstName": "Alice", "lastName": "Yamada" },
    "ticketName": "一般参加",
    "children": [
      {
        "id": "660e9511-...",
        "invitedByEntryId": "550e8400-...",
        "invitationGeneration": 1,
        "invitationRootEntryId": "550e8400-...",
        "user": { "id": "1a2b3c4d-...", "slug": "bob-sato", "firstName": "Bob", "lastName": "Sato" },
        "ticketName": "招待参加",
        "children": [],
        "childrenTotalCount": 0,
        "childrenNextCursor": null
      }
    ],
    "childrenTotalCount": 3,
    "childrenNextCursor": "eyJ2IjoxLCJwYXJlbnRFbnRyeUlkIjoiNTUwZTg0MDAtLi4uIn0"
  }
}