OpenCourt Developers
API ReferenceEvents

Get an event

GET/v1/events/{id}

Fetch a single event by id — the full sign-up unit: every session (one club operating day) with its time_slots, plus the participants roster and host. The roster is capped at 500; participant_count is the authoritative total (when it exceeds participants.length, the roster is truncated). Returns 404 if the id is not an event of the club tied to your API key.

Authorization

bearerAuth
AuthorizationBearer <token>

Your club API key. Send it as Authorization: Bearer oc_live_….

In: header

Path Parameters

id*string

The event id (the event_id on a schedule item).

Response Body

application/json

application/json

application/json

application/json

curl -X GET "https://api.getopencourt.com/v1/events/e1d2c3b4-a5f6-4789-9abc-0123456789ab"
{
  "id": "e1d2c3b4-a5f6-4789-9abc-0123456789ab",
  "object": "event",
  "type": "league",
  "title": "Monday Night League",
  "open": true,
  "privacy": "public",
  "host": {
    "customer_id": "d1f4e9c2-3a5b-4c6d-8e7f-0a1b2c3d4e5f",
    "first_name": "Karen",
    "last_name": "Smith",
    "email": "karen@club.dev"
  },
  "participant_count": 12,
  "max_participants": 16,
  "spots_available": 4,
  "tags": [
    {
      "id": "a1c3e5f7-2b4d-4c6e-8a0b-1d3f5a7c9e1b",
      "name": "Intermediate"
    }
  ],
  "sessions": [
    {
      "date": "2026-06-15",
      "time_slots": [
        {
          "start": "2026-06-15T19:00:00-04:00",
          "end": "2026-06-15T20:30:00-04:00",
          "spaces": [
            {
              "id": "b2d4f6a8-1c3e-4a5b-9d7c-0e2f4a6b8c1d",
              "name": "Court 1"
            }
          ]
        }
      ]
    },
    {
      "date": "2026-06-22",
      "time_slots": [
        {
          "start": "2026-06-22T19:00:00-04:00",
          "end": "2026-06-22T20:30:00-04:00",
          "spaces": [
            {
              "id": "b2d4f6a8-1c3e-4a5b-9d7c-0e2f4a6b8c1d",
              "name": "Court 1"
            }
          ]
        }
      ]
    }
  ],
  "participants": [
    {
      "id": "c0ffee00-1111-4222-8333-444455556666",
      "first_name": "Sam",
      "last_name": "Lee",
      "email": "sam@example.com",
      "customer_id": "a1b2c3d4-e5f6-4789-9abc-0123456789ab",
      "check_in_status": "checked_in"
    },
    {
      "id": "b0bb1e00-2222-4333-8444-555566667777",
      "first_name": "Jordan",
      "last_name": null,
      "email": null,
      "customer_id": null,
      "check_in_status": "none"
    }
  ],
  "created_at": "2026-06-01T09:12:44.000Z",
  "updated_at": "2026-06-14T17:03:10.000Z",
  "canceled_at": null
}
{
  "error": {
    "type": "string",
    "code": "string",
    "message": "string",
    "param": "string",
    "request_id": "string"
  }
}
{
  "error": {
    "type": "string",
    "code": "string",
    "message": "string",
    "param": "string",
    "request_id": "string"
  }
}
{
  "error": {
    "type": "string",
    "code": "string",
    "message": "string",
    "param": "string",
    "request_id": "string"
  }
}

List schedule items GET

The club's schedule as a time-ordered feed of session items — event occurrences and court bookings — one item per (event, club operating day).

List an event's participants GET

The event's roster, oldest first — the same order as the inline roster on GET /v1/events/{id}, and the UNCAPPED read.