---
title: "Get documentary relationships of a company"
method: GET
path: "/api/v1/company/{slug}/relationships"
tags: ["Companies"]
---

# Get documentary relationships of a company

`GET /api/v1/company/{slug}/relationships`

## Request

- Base URL: `https://openmercantil.es`
- URL: `https://openmercantil.es/api/v1/company/{slug}/relationships`
- Auth: one of:
  - none
  - API key in header `X-API-Key`
  - HTTP bearer
- TypeScript: <https://skmtc.dev/openmercantil/apis/openmercantil-public-api/docs/api/v1/company/:slug/relationships/get.ts> (a function with typed inputs; its response is checked against the schema)

Return all documented relationships between this company and other entities (companies, persons, contracts, grants, IP assets, organisms). Each relationship includes source attribution, date, confidence level and evidence URL. LEGAL NOTE: relationships are documentary only — they do not imply control, responsibility, irregularity or current vigency.

## Path parameters

- `slug` string, required

## Query parameters

- `type` 'officer' | 'domicile' | 'contract' | 'grant' | 'ip' | 'corporate' | 'mention'
- `confidence` 'high' | 'medium' | 'low'

## Response `200`

Documented relationships list

- CompanyRelationshipsResponse
  - `slug` string
  - `count` integer
  - `relationships` RelationshipRecord[]
    - `source_slug` string
    - `relationship_type` string, nullable
    - `name` string, nullable
    - `slug` string, nullable
    - `date` string, nullable
    - `official_url` string, uri, nullable
  - `items` RelationshipRecord[]
    - `source_slug` string
    - `relationship_type` string, nullable
    - `name` string, nullable
    - `slug` string, nullable
    - `date` string, nullable
    - `official_url` string, uri, nullable
  - `source_catalog_version` string
  - `_source_catalog` SourceCatalogEnvelope
    - `catalog_version` string, required
    - `policy_fingerprint` string, required
    - `policy_effective_date` string, date
    - `sources` object, required

## Other responses

- `400`: Invalid request
- `404`: Resource not found
- `429`: Rate limit exceeded
- `500`: The bounded operation failed without exposing internal exception details.
- `503`: The public read failed closed because its legal source catalog, subject classification, bounded projection, database helper or required artifact is unavailable. Clients must not infer an empty result.

## Changes

- **2026-07-26** `996f96a11758`: 47 info
  - api operation id `getCompanyBySlugRelationships` was added
  - the endpoint scheme security `apiKey` was added to the API
  - the endpoint scheme security `bearerAuth` was added to the API
  - added the non-success response with the status `400`
  - …43 more

[Operation history](https://skmtc.dev/openmercantil/apis/openmercantil-public-api/changes/api/v1/company/:slug/relationships/get.md)

---

[API](https://skmtc.dev/openmercantil/apis/openmercantil-public-api.md) - [All operations](https://skmtc.dev/openmercantil/apis/openmercantil-public-api/llms.txt) - [OpenAPI document](https://skmtc.dev/openmercantil/apis/openmercantil-public-api/revisions/601ff6123c86?raw)