---
title: "Entity Relationship Graph"
method: GET
path: "/v1/relationships"
tags: ["Agent-Native"]
---

# Entity Relationship Graph

`GET /v1/relationships`

## Request

- Base URL: `https://north7.ai`
- URL: `https://north7.ai/v1/relationships`
- Auth: none declared

Query the NORTH7 knowledge graph. Returns entities (countries, companies, assets, commodities, sectors, crises) and their relationships.

**Use cases:**
- 'What assets are affected by Iran?' → /v1/relationships?entity=IR
- 'What impacts crude oil?' → /v1/relationships?entity=CL=F
- 'Show all crises' → /v1/relationships?type=crisis

FREE — no API key required.

## Query parameters

- `entity` string: Entity ID to query, e.g. 'IR' (Iran), 'CL=F' (oil), 'NVDA', 'energy'
- `type` string: Filter by entity type: country, company, asset, commodity, sector, crisis, region

## Headers

- `X-API-Key` string

## Response `200`

Successful Response

- unknown

## Other responses

- `422`: Validation Error

---

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