Skip to content
Optiwork API Docs

Find events by meeting room

GET
/events/references/video-conferences/hashes/{hash}
curl --request GET \
  --url https://calendar.work.optidata.cloud/api/events/references/video-conferences/hashes/a2885696-9166-402c-b443-02b486652916 \
  --header 'Authorization: Bearer <token>'

Given the identifier of a meeting room, returns the events that meet in it — what a conferencing client calls to label a room with the meeting it belongs to and to show who is expected.

The payload is flatter than an event record: one object per event, in snake_case, carrying the room URL plus the occurrence’s title, times, organizer and attendees. Any event whose details cannot be read comes back with its identifiers filled in and the descriptive fields null, rather than failing the whole call.

Authorizations

Section titled “Authorizations”

Parameters

Section titled “ Parameters ”

Path Parameters

Section titled “Path Parameters”
hash
required
string

Identifier of the meeting room, as it appears in the event’s videoConferenceUrl.

Responses

Section titled “ Responses ”

200

Section titled “200”

Events that reference the room. Empty when the room is unknown.

Media typeapplication/json
object
events
required
Array<object>

An event that meets in a given room. Reported in snake_case, and flatter than an event record. When the event’s details cannot be read, the descriptive fields come back null.

object
event_id
string | null
event_uid
string | null
calendar_id
string | null
video_conference_url
string | null
name
string | null
description
string | null
location
string | null
start
string | null
end
string | null
is_all_day
boolean
organizer
object
email
string | null
name
string | null
type
string | null
avatar_url
string | null
attendees
Array<object>
object
email
string | null
name
string | null
type
string | null
avatar_url
string | null
participation_status
string | null
Examples
{
  "events": [
    {
      "event_id": "4167",
      "event_uid": "de373eee-9440-4420-a53b-1be5ccd4eb18",
      "calendar_id": "10",
      "video_conference_url": "https://meet.optidata.cloud/rooms/a2885696-9166-402c-b443-02b486652916",
      "name": "Sprint review",
      "description": "Demo of the August milestone.",
      "location": "",
      "start": "2026-08-24T14:00:00-03:00",
      "end": "2026-08-24T15:00:00-03:00",
      "is_all_day": false,
      "organizer": {
        "email": "jane.doe@acme.example",
        "name": "Jane Doe",
        "type": "user",
        "avatar_url": null
      },
      "attendees": [
        {
          "email": "john.smith@acme.example",
          "name": "John Smith",
          "type": "user",
          "avatar_url": null,
          "participation_status": "ACCEPTED"
        }
      ]
    }
  ]
}

401

Section titled “401”

Missing, malformed or expired authentication key.

Media typeapplication/json

Authentication failures use an error key rather than message.

object
error
required
string
Examples
Examplemissing

No bearer token sent

{
  "error": "JWT passport exception: Missing bearer token in request"
}

429

Section titled “429”

Rate limit exceeded. Retry after the window resets.

Media typeapplication/json

Generic error envelope used by policy, binding and framework failures.

object
message
required

Human-readable description of the failure.

string
Examples
Examplethrottled
{
  "message": "Too Many Attempts."
}