# Read the calendar

The caller's own calendar between two instants (from, to - RFC3339), read live from whichever vendor they connected (Google or Microsoft); entries this service booked carry \`ours\` with the record they are about. This read also rings due meeting reminders and clears meetings deleted at the vendor, so it is not a cheap poll. Pass rowId (with definitionKey) instead to list one RECORD's meetings out of our own table, which reaches no vendor at all.

Access class: `workspace`.

## Endpoint

`GET /v1/calendar/events`

## Parameters

| Name | In | Type | Required |
| --- | --- | --- | --- |
| body | query | null | No |
| params | query | object | No |
| query | query | object | No |

## Responses

### 200

the action's answer

Content type: `application/json`.

```json
{}
```

### default

a refusal: `{"error": "<what a person needs to read>"}`. 401 no credential, 402 the plan does not include this, 403 the seat does not, 404 the thing does not exist or is not yours to see.

Content type: `application/json`.

```json
{
  "error": "string"
}
```