---
title: "List entity relationships"
method: GET
path: "/v1/users/{user_id}/entities/relationships"
tags: ["Entities"]
---

# List entity relationships

`GET /v1/users/{user_id}/entities/relationships`

## Request

- Base URL: `http://0.0.0.0:3000`
- URL: `http://0.0.0.0:3000/v1/users/{user_id}/entities/relationships`
- Auth: none declared

Returns pairs of entities that co-occur on messages, meetings, or calendar events, with interaction count and recency.

## Path parameters

- `user_id` string, uuid, required

## Query parameters

- `limit` string
- `min_interactions` string
- `include_bots` 'true' | 'false'

## Response `200`

Default Response

- object
  - `success` true, required
  - `data` object[], required
    - `entity_a` object, required
      - `id` string, required
      - `name` string, required
      - `entity_type` string, required
      - `external_ids` string[], required
      - `is_bot` boolean, required
      - `avatar_uri` string, nullable, required
    - `entity_b` object, required
      - `id` string, required
      - `name` string, required
      - `entity_type` string, required
      - `external_ids` string[], required
      - `is_bot` boolean, required
      - `avatar_uri` string, nullable, required
    - `co_occurrence_count` integer, required
    - `last_interaction_at` string, nullable, required
  - `pagination` object, required
    - `limit` number, required
    - `offset` number, required
    - `has_more` boolean, required
    - `total_count` number

## Other responses

- `400`: Default Response
- `403`: Default Response
- `500`: Default Response

---

[API](https://skmtc.dev/attrove/apis/attrove-api.md) · [All operations](https://skmtc.dev/attrove/apis/attrove-api/llms.txt) · [OpenAPI document](https://skmtc.dev/attrove/apis/attrove-api/revisions/fcdc818b45cb?raw)