# See what is coming up, and what will be recorded

> Each meeting in the window with `willRecord`, and when false a `skipReason` naming why — the same decision the recording engine itself makes, resolved as you ask rather than looked up afterwards. This is the endpoint to answer "will this be recorded". The window may not exceed 92 days.

`GET https://api-notetaker.nabrah.ai/ext/v1/meetings/schedule`

Requires an API key in the `Authorization` header.

Each meeting in the window with `willRecord`, and when false a `skipReason` naming why — the same decision the recording engine itself makes, resolved as you ask rather than looked up afterwards. This is the endpoint to answer "will this be recorded". The window may not exceed 92 days.

## Query parameters

- `from` (string · date-time, required)
- `to` (string · date-time, required)

## Responses

- `200` — What is coming up, and what will be recorded.
- `401` — No key, an unknown key, or one that has been revoked or has expired.
- `403` — The key is read only, or lacks the reach for this route.
- `404` — No such record — or one that belongs to another account.
- `422` — The body or query failed validation; `details` names the field.
- `429` — Too many requests. `Retry-After` says how long to wait.

### 200 example

```json
{
  "data": {
    "rows": [
      {
        "meetingId": "00000000-0000-0000-0000-000000000000",
        "runId": "string",
        "platform": "string",
        "phase": "string",
        "state": "string",
        "skipReason": "string",
        "willRecord": true,
        "detail": "string",
        "waitedSeconds": 0,
        "recordingSeconds": 0,
        "joinedAt": "string",
        "endedAt": "string",
        "hasNotes": true
      }
    ],
    "total": 0,
    "limit": 0,
    "offset": 0
  }
}
```

### 401 example

```json
{
  "error": {
    "code": "string",
    "message": "string",
    "details": [
      {
        "path": "string",
        "message": "string"
      }
    ]
  }
}
```

### 403 example

```json
{
  "error": {
    "code": "string",
    "message": "string",
    "details": [
      {
        "path": "string",
        "message": "string"
      }
    ]
  }
}
```

### 404 example

```json
{
  "error": {
    "code": "string",
    "message": "string",
    "details": [
      {
        "path": "string",
        "message": "string"
      }
    ]
  }
}
```

### 422 example

```json
{
  "error": {
    "code": "string",
    "message": "string",
    "details": [
      {
        "path": "string",
        "message": "string"
      }
    ]
  }
}
```

### 429 example

```json
{
  "error": {
    "code": "string",
    "message": "string",
    "details": [
      {
        "path": "string",
        "message": "string"
      }
    ]
  }
}
```