---
title: "network.machines.read · OpenVibe.Services"
canonical: "https://openvibe.services/docs/capabilities/network.machines.read"
updated: null
---

# network.machines.read · OpenVibe.Services

HTML: [network.machines.read · OpenVibe.Services](https://openvibe.services/docs/capabilities/network.machines.read)

# `network.machines.read`

Generated at 2026-11-13 06:25:48 UTC from [`openvibe-contracts v0.419.0`](https://github.com/OpenVibers/OpenVibe.Contracts/tree/v0.419.0) and [`openvibe-sdk v0.161.0`](https://github.com/OpenVibers/OpenVibe.SDK/tree/v0.161.0).

Grantable to apps: request it for an app on its project page. Network approves it only inside the project's allowance.

Read a person's own machines: the list, one machine, and the catalogue of roles. A person reads their own with their own token; an app needs the person's consent for this scope (it is a public capability, so it can be granted to an app, and the app then acts only on behalf of the person who consented).

- Owner: network (token audience `openvibe.network`)
- Version: 1.0
- Status: active
- Visibility: public
- Resource constraints: owner
- Quota class: network-read
- Permissions: machines:read
- Input: [common.no-body@1](/docs/contracts/common.no-body)
- Output: network.machine-list-result@1
- Events: —
- Implemented by: - `GET /api/v1/machines`
- `GET /api/v1/machines/:id`
- `GET /api/v1/machines/roles`

[These routes in the API explorer](/docs/api/network#cap-network.machines.read)