---
title: "List connections"
method: GET
path: "/organizations/{cin}/connections"
tags: ["People"]
---

# List connections

`GET /organizations/{cin}/connections`

## Request

- Base URL: `https://api.apino.sk/api/v1`
- URL: `https://api.apino.sk/api/v1/organizations/{cin}/connections`
- Auth: HTTP bearer

Discover connections between organizations through shared people. Returns organizations that share statutory body members or stakeholders with the specified organization.

**Paid plans only.** On the free plan this endpoint answers `403`: it tells where a person appears across companies, which is more than checking one business partner needs.

> **People are matched by normalized name only.** The register's personal identifier (rodné číslo) is removed during extraction to comply with GDPR, so two individuals who share a name cannot be told apart. For common Slovak names this returns organizations that have no actual relationship. Treat the results as candidates to verify rather than confirmed links — `shared_count` counts matching names, not verified people.

## Path parameters

- `cin` string, required

## Query parameters

- `country` 'SK' | 'CZ'
- `active` boolean
- `limit` integer
- `offset` integer

## Response `200`

Paginated list of connected organizations

- ConnectionList
  - `data` ConnectionResponse[]
    - `organization_id` integer: Connected organization ID
    - `country_code` 'SK' | 'CZ': Country the connected organization belongs to.
    - `organization_ico` string: Connected organization CIN
    - `organization_name` string: Connected organization name
    - `shared_people` string[]: Names of shared people
    - `shared_count` integer: Number of shared people
  - `count` integer: Number of results in this page
  - `limit` integer: Limit used
  - `offset` integer: Offset used
  - `has_more` boolean: Whether more results exist beyond this page

## Other responses

- `300`: CIN exists in both registers — call again with `?country=SK` or `?country=CZ`
- `400`: Validation error
- `401`: Missing or invalid API key
- `404`: Resource not found
- `429`: Rate limit exceeded

---

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