Read one meeting
GET
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.
apiKeyheader
AuthorizationBearer <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.
id*stringThe meeting id, from the list of meetings.
Length
1 <= lengthcalendarId?stringWhich calendar. Leave out for the agent's own calendar if it has one, otherwise the main calendar.
Length
1 <= length <= 320mailbox?stringAn agent's email address, to use that mailbox's own calendar.
Length
length <= 320connectionId?stringOnly needed when more than one calendar account is connected: the id of the account to use, from GET /v1/calendar/status.
Length
1 <= length <= 64The meeting
application/json- response
event*summary*stringcurl "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."}