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

# get_entity_relations

> Browse graph edges and connections for an entity.

# get\_entity\_relations

Retrieves outgoing and incoming edges (fact connections) for a given entity. Supports optional semantic filtering, which is useful when an entity has many connections and you need to find specific facts.

## Parameters

| Parameter | Type    | Required | Default | Description                                                                           |
| --------- | ------- | -------- | ------- | ------------------------------------------------------------------------------------- |
| `type`    | string  | Yes      | --      | Entity type                                                                           |
| `name`    | string  | Yes      | --      | Entity name                                                                           |
| `query`   | string  | No       | `null`  | Optional semantic search query to filter relations by intent or connected entity name |
| `limit`   | integer | No       | `100`   | Max relations to return (1--1000)                                                     |

## Read-only

Yes. This tool only reads from your memory.

## Example usage

```json theme={null}
{
  "type": "person",
  "name": "Alice",
  "query": "employment"
}
```

This returns only Alice's work-related connections, filtering out unrelated facts.

```json theme={null}
{
  "type": "project",
  "name": "my-api",
  "limit": 20
}
```

Returns up to 20 connections for the "my-api" project.

<Tip>
  Use the `query` parameter to narrow results for highly-connected entities. For example, filtering a person entity with `query="employment"` returns only work-related facts, while `query="preferences"` returns their stated preferences.
</Tip>

## When to use

* Exploring how an entity connects to others in the graph
* Finding specific facts about an entity (use the `query` filter)
* Building a comprehensive picture after reading an entity's dossier with `get_entity`

## Typical workflow

```
1. get_entity(type="person", name="Alice")          → read dossier
2. get_entity_relations(type="person", name="Alice") → explore connections
3. get_entity(type="organization", name="Acme Corp") → follow a connection
```