API Reference

List Sessions

Fetch a list of active and historical sessions.

GET/api/v1/sessions

Fetches all historical and active sessions. Systems can pass `?status=open` or `?status=closed` to filter the list. Returns session start and end times, and the total attendee count.

Authorization

Bearer Token Required

Include your API key in the Authorization header as Bearer attg_live_…

Headers

Parameter	Type	Required	Description
`Authorization`	string	required	Bearer token. Format: `Bearer attg_live_…`

Query Parameters

Parameter	Type	Required	Description
`status`	string	optional	Filter by status: `open` or `closed`
`limit`	number	optional	Max results (default 100, max 500)
`offset`	number	optional	Pagination offset (default 0)

Rate Limits

120 requests per 60s window per IP address.

Responses

Sessions returned successfully.

{
  "ok": true,
  "data": [
    {
      "id": "uuid",
      "name": "Math 101",
      "status": "open",
      "attendee_count": 5
    }
  ]
}

curl -X GET "https://attend-go.com/api/v1/sessions?status=open" \
  -H "Authorization: Bearer attg_live_YOUR_API_KEY"

200Response

{
  "ok": true,
  "data": [
    {
      "id": "uuid",
      "name": "Math 101",
      "status": "open",
      "attendee_count": 5
    }
  ]
}