> ## Documentation Index
> Fetch the complete documentation index at: https://docs.marcus.involvecloud.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Public API

> Read-only access to your estate for CMDBs, incident tools, dashboards and SIEMs.

The M.A.R.C.U.S. Public API gives other systems read-only access to your estate: sync devices and assets into a CMDB, mirror alerts into an incident tool, feed dashboards, report on which rooms are ready each morning, or send the audit trail to a SIEM.

Every request is scoped to the customer the token belongs to, and the API never changes anything — it only reads.

## Base URL

```
https://api.uat.involvecloud.com
```

All endpoints are under `/pub/v1`. Requests and responses are JSON over HTTPS.

## Make your first call

**1. Create a token**

In the portal, go to **Settings → API tokens** and select **New token**. Choose the scopes it needs and an expiry. Copy the token when it's shown: it isn't displayed again. See [Authentication](https://docs.marcus.involvecloud.com/api-reference/authentication.md).

**2. Check it works**

```bash theme={null}
curl -H "Authorization: Bearer avb_..." https://api.uat.involvecloud.com/pub/v1/ping
```

The reply names the customer and the token's scopes.

**3. Read some data**

```bash theme={null}
curl -H "Authorization: Bearer avb_..." "https://api.uat.involvecloud.com/pub/v1/devices?status=offline"
```

## Endpoints

| Endpoint | What it does | Scope |
| - | - | - |
| [`GET /pub/v1/ping`](https://docs.marcus.involvecloud.com/api-reference/meta/verify-a-token) | Verify a token | Any |
| [`GET /pub/v1/devices`](https://docs.marcus.involvecloud.com/api-reference/devices/list-devices) | List devices | `view.dashboard` |
| [`GET /pub/v1/devices/{id}`](https://docs.marcus.involvecloud.com/api-reference/devices/get-a-device) | Get a device | `view.dashboard` |
| [`GET /pub/v1/devices/{id}/telemetry`](https://docs.marcus.involvecloud.com/api-reference/devices/get-latest-telemetry) | Get latest telemetry | `view.dashboard` |
| [`GET /pub/v1/devices/{id}/events`](https://docs.marcus.involvecloud.com/api-reference/devices/list-events-for-a-device) | List events for a device | `view.dashboard` |
| [`GET /pub/v1/firmware`](https://docs.marcus.involvecloud.com/api-reference/firmware/list-firmware-versions) | List firmware versions | `view.firmware` |
| [`GET /pub/v1/buildings`](https://docs.marcus.involvecloud.com/api-reference/hierarchy/list-buildings) | List buildings | `view.dashboard` |
| [`GET /pub/v1/rooms`](https://docs.marcus.involvecloud.com/api-reference/hierarchy/list-rooms) | List rooms | `view.dashboard` |
| [`GET /pub/v1/assets`](https://docs.marcus.involvecloud.com/api-reference/assets/list-assets) | List assets | `view.assets` |
| [`GET /pub/v1/assets/{id}`](https://docs.marcus.involvecloud.com/api-reference/assets/get-one-asset) | Get one asset | `view.assets` |
| [`GET /pub/v1/alerts`](https://docs.marcus.involvecloud.com/api-reference/alerts/list-alerts) | List alerts | `view.dashboard` |
| [`GET /pub/v1/events`](https://docs.marcus.involvecloud.com/api-reference/events/list-events) | List events | `view.dashboard` |
| [`GET /pub/v1/audit`](https://docs.marcus.involvecloud.com/api-reference/audit/list-audit-entries) | List audit entries | `view.audit` |
| [`GET /pub/v1/room-readiness/rooms`](https://docs.marcus.involvecloud.com/api-reference/room-readiness/list-rooms-with-their-latest-runs) | List rooms with their latest runs | `nightly.view` |
| [`GET /pub/v1/room-readiness/runs`](https://docs.marcus.involvecloud.com/api-reference/room-readiness/list-runs) | List runs | `nightly.view` |
| [`GET /pub/v1/room-readiness/runs/{id}`](https://docs.marcus.involvecloud.com/api-reference/room-readiness/get-a-run-with-its-steps) | Get a run with its steps | `nightly.view` |

> [!TIP]
>
> The OpenAPI 3.1 document is also served by the API itself at `https://api.uat.involvecloud.com/pub/v1/openapi.json`, for importing into Postman, Insomnia or a code generator.

Updated 27 Oct 2026 12:07 · page b890027


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.