---
title: "Director network graph"
method: GET
path: "/directors/network"
tags: ["Directors"]
---

# Director network graph

`GET /directors/network`

## Request

- Base URL: `https://api.prometiam.com/functions/v1/risk-api`
- URL: `https://api.prometiam.com/functions/v1/risk-api/directors/network`
- Auth: HTTP bearer

Find people who direct multiple companies. Useful for fraud detection (cross-corporate concentration) and watchlist construction.

## Query parameters

- `country` 'ES' | 'FR' | 'GB' | 'IE' | 'PL' | 'NO' | 'FI' | 'SE' | 'HR' | 'BE' | 'DK' | 'EE' | 'SK' | 'CH' | 'LV' | 'CY' | 'RO' | 'LT' | 'CA' | 'AU' | 'JP' | 'IL' | 'BR' | 'CO' | 'SG' | 'TW' | 'CZ' | 'DE' | 'US'
- `min_companies` integer
- `legal_entities` boolean
- `limit` integer
- `offset` integer

## Response `200`

Director network results

- object
  - `data` DirectorNetworkNode[]
    - `person_id` integer
    - `person_name` string: Was documented as full_name.
    - `company_count` integer: Number of linked companies.
    - `is_legal_entity` boolean: True when the 'director' is itself a company.
    - `company_ids` integer[]
    - `company_names` string[]
  - `meta` Meta
    - `query_ms` integer
    - `search_mode` string
    - `country` 'ES' | 'FR' | 'GB' | 'IE' | 'PL' | 'NO' | 'FI' | 'SE' | 'HR' | 'BE' | 'DK' | 'EE' | 'SK' | 'CH' | 'LV' | 'CY' | 'RO' | 'LT' | 'CA' | 'AU' | 'JP' | 'IL' | 'BR' | 'CO' | 'SG' | 'TW' | 'CZ' | 'DE' | 'US'
    - `rate_limit` RateLimitMeta
      - `rpm_remaining` integer
      - `daily_remaining` integer

## Other responses

- `401`: Missing, invalid, or expired API key
- `403`: Key lacks the required scope or country access
- `429`: Rate limit exceeded — see `Retry-After` header for seconds until reset

---

[API](https://skmtc.dev/prometiam/apis/prometiam-risk-intelligence-api.md) · [All operations](https://skmtc.dev/prometiam/apis/prometiam-risk-intelligence-api/llms.txt) · [OpenAPI document](https://skmtc.dev/prometiam/apis/prometiam-risk-intelligence-api/revisions/3ee0626d5a45?raw)