---
title: "List Relationships"
method: GET
path: "/api/relationships"
tags: ["relationships"]
---

# List Relationships

`GET /api/relationships`

## Request

- Base URL: `https://www.gateco.ai` (the document declares no server; this is the origin it was published from)
- URL: `https://www.gateco.ai/api/relationships`
- Auth: none declared

List relationship edges for the current organization.

All three filter parameters are optional and combinable.  Results are
always scoped to the caller's organization.

Returns:
    A paginated envelope ``{"data": [...], "meta": {...}}``.

## Query parameters

- `page` integer
- `per_page` integer
- `subject_id` string, uuid, nullable: Filter by subject_principal_id
- `relation` string, nullable: Filter by relation_name
- `object_id` string, uuid, nullable: Filter by object_resource_id

## Response `200`

Successful Response

- object

## Other responses

- `422`: Validation Error

---

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