Returns uptime for multiple recordings in one call. Use this in place of repeatedly calling [`GET /recording/:id/uptime`](/content/api/core/recordings/uptime/index.html).

> **Date format:** uptime endpoints take **date-only**`YYYY-MM-DD` for `start` and `end`. Full ISO 8601 timestamps are rejected.

## Body parameters [Permalink](/content/api/core/recordings/uptimes/#body-parameters/index.html)

| Parameter | Type | Required | Description |
| --- | --- | --- | --- |
| `start` | string (`YYYY-MM-DD`) | yes | Inclusive start date |
| `end` | string (`YYYY-MM-DD`) | yes | Inclusive end date |
| `recids` | string[] | no | List of recording IDs to query. **Omit** to query all recordings you have access to. |

## Example request [Permalink](/content/api/core/recordings/uptimes/#example-request/index.html)

```
POST https://api.auravisionlabs.com/v1/recording/uptimes
Authorization: Bearer <your_token>
Content-Type: application/json
```

```
{
  "recids": ["64a1b2c3d4e5f6a7b8c9d0e4", "64a1b2c3d4e5f6a7b8c9d0e5"],
  "start": "2024-04-01",
  "end": "2024-04-07"
}
```

## Example response [Permalink](/content/api/core/recordings/uptimes/#example-response/index.html)

Returns an array — one object per recording — with the same shape as the single-recording response:

```
[
  {
    "recording": {
      "id": "64a1b2c3d4e5f6a7b8c9d0e4",
      "name": "Entrance Camera",
      "organisation": "64a1b2c3d4e5f6a7b8c9d0e2",
      "cameraServer": "64a1b2c3d4e5f6a7b8c9d0e7",
      "location": "64a1b2c3d4e5f6a7b8c9d0e3",
      "useUploadingSchedule": false,
      "timezone": "Europe/London"
    },
    "uptime": [
      {
        "index": "2024-04-01 10:00",
        "withinSchedule": true,
        "segmentsExpected": 4,
        "segmentsReceived": 4,
        "avgUptimeOnSegment": 0.98,
        "pcSegmentsRecieved": 1.0,
        "overallUptime": 0.98
      }
    ]
  },
  {
    "recording": {
      "id": "64a1b2c3d4e5f6a7b8c9d0e5",
      "name": "Back Aisle Camera",
      "organisation": "64a1b2c3d4e5f6a7b8c9d0e2",
      "cameraServer": "64a1b2c3d4e5f6a7b8c9d0e7",
      "location": "64a1b2c3d4e5f6a7b8c9d0e3",
      "useUploadingSchedule": true,
      "timezone": "Europe/London"
    },
    "uptime": [
      {
        "index": "2024-04-01 10:00",
        "withinSchedule": true,
        "segmentsExpected": 4,
        "segmentsReceived": 3,
        "avgUptimeOnSegment": 0.91,
        "pcSegmentsRecieved": 0.75,
        "overallUptime": 0.68
      }
    ]
  }
]
```

## Related [Permalink](/content/api/core/recordings/uptimes/#related/index.html)

- [Get recording uptime](/content/api/core/recordings/uptime/index.html) — single recording
- [Historic uptime (Metrics API)](/content/api/metrics/uptime/historic/index.html)
- [Real-time status](/content/api/metrics/uptime/realtime/index.html)