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

# network.friends.read · OpenVibe.Services

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

# `network.friends.read`

Generated at 2026-11-17 06:52:56 UTC from [`openvibe-contracts v0.443.0`](https://github.com/OpenVibers/OpenVibe.Contracts/tree/v0.443.0) and [`openvibe-sdk v0.177.0`](https://github.com/OpenVibers/OpenVibe.SDK/tree/v0.177.0).

Not grantable to apps (active, first-party).

Read a person's mutual friends (subjects only), as an owning service: Chat's contacts and DM starts, Link's sharing with a friend (plan §AB.51). The person's own view is GET /api/v1/me/friends with their token. Never grantable to apps.

- Owner: network (token audience `openvibe.network`)
- Version: 1.0
- Status: active
- Visibility: first-party
- Resource constraints: none
- Quota class: friends-read
- Permissions: friends:read
- Input: [common.no-body@1](/docs/contracts/common.no-body)
- Output: network.friend-subjects@1
- Events: network.friend.requested, network.friend.accepted, network.friend.removed
- Implemented by: - `GET /internal/friends`

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