RankGun logoRankGun

Get Session

Get full details for a single session including participants.

GET /api/sessions/{sessionId}

Returns full details for a single session including its participant list.

Returns 404 if the session does not exist or belongs to a different workspace. The API does not distinguish between these cases to avoid leaking the existence of other workspaces' data.

Headers

Prop

Type

Path Parameters

Prop

Type

curl https://api.rankgun.works/api/sessions/k7abc123 \
  -H "x-api-key: YOUR_API_KEY"

Response

200 OK

{
  "success": true,
  "session": {
    "id": "k7...",
    "title": "Saturday Training",
    "sessionTypeId": "j5...",
    "sessionTypeName": "Training",
    "status": "scheduled",
    "scheduledStartAt": 1712345678,
    "scheduledEndAt": 1712349278,
    "actualStartAt": null,
    "actualEndAt": null,
    "createdByRobloxId": 123456,
    "createdByUsername": "Builderman",
    "cancelledAt": null,
    "cancellationReason": null,
    "notes": "Bring your A game",
    "summary": null,
    "createdAt": 1712000000,
    "updatedAt": 1712000000
  },
  "participants": [
    {
      "robloxId": 987654,
      "robloxUsername": "Player1",
      "displayName": "Player One",
      "role": "Attendee",
      "attendanceStatus": "confirmed",
      "invitedAt": 1712000100,
      "respondedAt": 1712001200
    }
  ]
}

All timestamp fields are seconds since epoch (Unix time). See the Timestamps section.

Session Detail Fields

Includes everything from List Sessions plus:

Prop

Type

Participant Fields

Prop

Type

Errors

StatusMeaning
401Missing API key.
403Invalid API key.
404Session not found, or belongs to a different workspace.
500Internal server error.
Was this page helpful?

On this page