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

generationsnumber

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

childrenLimitnumber

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

cursorstring

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

Response

Field	Type	Description
`entryId`	string	Root entry ID
`entry`	object	Root node. Each node has children / childrenTotalCount / childrenNextCursor (recursive)

curl https://api.4s.link/events/EVENT_ID/entries/:entryId/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"
  }
}