People

Search people

Search for people (statutory body members, stakeholders) across all organizations by name. Uses trigram similarity for fuzzy matching — handles typos and partial names.

Paid plans only. On the free plan this endpoint answers 403. Who runs one given company stays available on every plan at /organizations/{cin}/people.

Results are grouped by person: each result contains the person's name and a list of all their organizational affiliations (roles across different companies).

get/people

Request

  • Base URL: https://api.apino.sk/api/v1
  • URL: https://api.apino.sk/api/v1/people
  • Auth: HTTP bearer

Query parameters

namestring required

Person name to search for (min 2 chars). Diacritics handled automatically.

countriesstring

Comma-separated country codes to include (SK, CZ). Default: SK (Slovak data only). Use "SK,CZ" to query both countries.

role'statutory_body' | 'stakeholder'

Filter by role type: statutory_body or stakeholder.

currentboolean

Current roles only. Default — all.

activeboolean

Filter to people at active (non-terminated) organizations only.

limitinteger

Max number of distinct people to return, 1–100.

offsetinteger

Pagination offset (over distinct people). Capped at 1000 — both ranking phases have to be re-scored from the start to honour an offset, so deeper paging is rejected with a 400 rather than served slowly. Narrow the name instead.

Response

Paginated list of people with their org affiliations

countinteger

Number of distinct people in this page

limitinteger

Limit used

offsetinteger

Offset used

has_moreboolean

Whether more results exist beyond this page

Changes

No recorded changes to this operation across all 1 revision of this API.