Read one meeting

GET
/v1/calendar/events/{id}

Returns one meeting: when, who is invited and whether they accepted, the description and the join link. A repeating meeting says so (series), and one date of it is an occurrence.

Requires an API key with the calendar:use scope.

Authorization

apiKey
headerAuthorizationBearer <token>

A secret API key from the dashboard (Developers → API keys): vl_live_…, or vl_test_… for test mode. Each operation says which scope the key needs.

Path Parameters

id*string

The meeting id, from the list of meetings.

Length1 <= length

Query Parameters

calendarId?string

Which calendar. Leave out for the agent's own calendar if it has one, otherwise the main calendar.

Length1 <= length <= 320
mailbox?string

An agent's email address, to use that mailbox's own calendar.

Lengthlength <= 320
connectionId?string

Only needed when more than one calendar account is connected: the id of the account to use, from GET /v1/calendar/status.

Length1 <= length <= 64

Response Body

The meeting

application/json
  1. response
event*
summary*string
Example Request
curl "https://api.vlayers.ai/v1/calendar/events/$EVENT_ID" \  -H "Authorization: Bearer $VOICELAYER_API_KEY"
Example Response
{  "event": {    "id": "evt_91",    "calendarId": "primary",    "title": "Demo call",    "description": "Intro and pricing",    "location": "",    "start": "2026-11-05T15:00:00.000Z",    "end": "2026-11-05T15:30:00.000Z",    "allDay": false,    "timeZone": "UTC",    "attendees": [      {        "email": "[email protected]",        "name": "Pat",        "response": "accepted"      }    ],    "organizerEmail": "[email protected]",    "recurrence": "none",    "seriesId": null,    "repeats": null,    "joinUrl": null,    "cancelled": false,    "iCalUid": null  },  "summary": "Demo call, 2026-11-05T15:00:00.000Z."}