---
title: "List Relationships"
method: GET
path: "/relations/"
tags: ["Relations"]
---

# List Relationships

`GET /relations/`

## Response `200`

- RelationshipExt[]
  - `channelId` string, uuid, nullable
  - `id` string, uuid, required
  - `relationId` string, uuid, required
  - `state` 'NONE' | 'FRIEND' | 'BLOCKED' | 'INCOMING_REQUEST' | 'OUTGOING_REQUEST', required
  - `user` UserExt, required — User with extended data including handle
    - `avatar` string, nullable
    - `category` 'BOT' | 'UNVERIFIED'
    - `description` string, nullable
    - `handle` string, nullable — The user's handle (if claimed)
    - `id` string, uuid, required
    - `name` string, required
    - `spaceOrder` string[], nullable — Persisted ordering of the user's spaces in the sidebar. Always present on responses; optional in the schema so the base `User` shape remains structurally assignable to `UserExt`.
  - `userId` string, uuid, required

---

[API](https://skmtc.net/mikotoio/apis/mikoto-superego.md) · [All operations](https://skmtc.net/mikotoio/apis/mikoto-superego/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/mikotoio/mikoto-superego/versions/2884da9c4ee0/schema)