> ## Documentation Index
> Fetch the complete documentation index at: https://docs.shoal.xyz/llms.txt
> Use this file to discover all available pages before exploring further.

# Get Entity Relationships

> List canonical relationships attached to one Shoal entity

Returns direct canonical relationships for one Shoal entity id.

## Path Parameters

* `id` (integer, required)

## Query Parameters

* `limit` (integer, optional, default 50, max 50)
* `offset` (integer, optional, default 0, max 250)

## Request

```bash cURL theme={null}
curl -X GET "https://api.shoal.xyz/v1/entities/23151/relationships?limit=25" \
  -H "Authorization: Bearer YOUR_API_KEY"
```

## Response (200)

```json theme={null}
{
  "entity": {
    "id": 23151,
    "canonicalName": "Ethereum",
    "displayName": "Ethereum",
    "entityType": "project",
    "status": "active",
    "aliases": ["Ethereum Foundation", "ETH"],
    "references": []
  },
  "limit": 25,
  "offset": 0,
  "data": [
    {
      "sourceEntityId": 23151,
      "targetEntityId": 41201,
      "relationshipType": "FOUNDATION_OF",
      "status": "active",
      "direction": "outbound",
      "searchExpand": true,
      "relatedEntity": {
        "id": 41201,
        "canonicalName": "Ethereum Foundation",
        "displayName": "Ethereum Foundation",
        "entityType": "foundation",
        "status": "active"
      }
    }
  ]
}
```

## Notes

* Relationship traversal is direct and canonical. It is not a full multi-hop graph query.
* `direction` is relative to the requested entity id.
* `searchExpand` indicates whether the relationship is currently used in Shoal expansion logic.

## Errors

* 400 if `id` is missing
* 404 if the entity does not exist
* 500 on internal server error