--- title: How can relatedPersons be identified in API calls? description: Learn how to use the relatedPersons field in the API to identify shareholders, authorized representatives, and active roles. --- [Skip to content](https://help.northdata.com/en/center/retrieving-relatedpersons-in-api-calls#main-content) - [English](https://help.northdata.com/en/center/retrieving-relatedpersons-in-api-calls) - [Deutsch](https://help.northdata.com/de/center/wie-kann-man-relatedpersons-in-api-abfragen-identifizieren) - [Français](https://help.northdata.com/fr/center/comment-les-personnes-liées-peuvent-elles-être-identifiées-dans-les-appels-api) English Show submenu for translations [![northdata-logo.png\]](https://help.northdata.com/hs-fs/hubfs/northdata-logo.png?width=250&height=86&name=northdata-logo.png)](https://www.northdata.com/) Open main navigation Close main navigation - - [English](https://help.northdata.com/en/center/retrieving-relatedpersons-in-api-calls) - [Deutsch](https://help.northdata.com/de/center/wie-kann-man-relatedpersons-in-api-abfragen-identifizieren) - [Français](https://help.northdata.com/fr/center/comment-les-personnes-liées-peuvent-elles-être-identifiées-dans-les-appels-api) English Show submenu for translations - [Back to the main page](https://www.northdata.com/) [Back to the main page](https://www.northdata.com/) Hello! How can we help? - There are no suggestions because the search field is empty. 1. [North Data Help Center](https://help.northdata.com/en/center?hsLang=en) 2. [Data Services](https://help.northdata.com/en/center/data-services?hsLang=en) 3. [API](https://help.northdata.com/en/center/data-services?hsLang=en#api) # How can relatedPersons be identified in API calls? ## Learn how to interpret relatedPersons in the API response and identify current shareholders or authorized representatives. The "relatedPersons" field in the API response provides information on individuals associated with a company. This data helps identify key figures such as authorized representatives, shareholders, and executives.  ### Understanding "relatedPersons" in the API Response When querying company data, the "relatedPersons" field lists individuals connected to the entity. Each person entry contains key attributes, including: - **Roles**: Defines the person’s function (e.g., director, shareholder, authorized representative). - **Date**: Indicates when the role became effective. - **Demotion**: Shows whether the role is no longer active (if "demotion=true"). To determine the most relevant individuals, sort the entries by the role’s date field in descending order and filter by the desired role type. For general API usage, see our article on[API Documentation.](https://help.northdata.com/en/center/where-can-i-find-documentation-for-the-api?hsLang=en) ### How to Find the Most Recent Shareholder To identify the most recent shareholders, refer to the `relatedPersons` and `relatedCompanies` fields of the company object. Each related entity has at least one associated role (found in the `roles` array). The `date` field within each role reflects when the role became effective. To find the most recent shareholders: 1. Sort `relatedPersons` and `relatedCompanies` by the `date` field in their roles. 2. Filter by the role type **Shareholder**. 3. Ensure the property `dir` has the value **Source**, meaning the identified entity is a shareholder of the requested company (and not the other way around). ### Identifying Inactive Persons To determine whether a person is still actively associated with a company, the `demotion` property in the `roles` array should be checked: - If the last recorded role of a person has `demotion=true`, it means they have been removed from that role and should no longer be considered an active representative. - Sorting the roles by `date` (ascending) allows you to find the most recent status of a person. This method ensures that only current, authorized individuals are taken into account. ### Handling Data Accuracy and Updates The accuracy of company-related data depends on various factors: - **Regular Data Updates:** The API continuously updates its database to reflect the most recent company filings. - **Source Variability:** Differences in publication formats and public register structures can sometimes introduce discrepancies, which are gradually refined through manual reviews and algorithm updates. To learn more about how North Data collects and processes data, see: [Where does North Data get its data?](https://help.northdata.com/en/center/from-where-does-north-data-get-its-data?hsLang=en)     - [My Account](https://help.northdata.com/en/center/my-account?hsLang=en#main-content) - [Account & Access](https://help.northdata.com/en/center/my-account?hsLang=en#account-access) - [Subscription & Cancellation](https://help.northdata.com/en/center/my-account?hsLang=en#subscription-cancellation) - [Contact & Support](https://help.northdata.com/en/center/my-account?hsLang=en#contact-support) - [Premium Services](https://help.northdata.com/en/center/premium-services?hsLang=en#main-content) - [General Information](https://help.northdata.com/en/center/premium-services?hsLang=en#general-information) - [Dossier](https://help.northdata.com/en/center/premium-services?hsLang=en#dossier) - [Network diagram](https://help.northdata.com/en/center/premium-services?hsLang=en#network-diagram) - [Watchlist](https://help.northdata.com/en/center/premium-services?hsLang=en#watchlist) - [Ownership & Flags](https://help.northdata.com/en/center/ownership-flags?hsLang=en#main-content) - [General Information](https://help.northdata.com/en/center/ownership-flags?hsLang=en#general-information) - [Ownership Features](https://help.northdata.com/en/center/ownership-flags?hsLang=en#ownership-features) - [Flag Features](https://help.northdata.com/en/center/ownership-flags?hsLang=en#flag-features) - [Data Services](https://help.northdata.com/en/center/data-services?hsLang=en#main-content) - [API](https://help.northdata.com/en/center/data-services?hsLang=en#api) - [Exports](https://help.northdata.com/en/center/data-services?hsLang=en#exports) - [Searching](https://help.northdata.com/en/center/searching?hsLang=en#main-content) - [Simple Search](https://help.northdata.com/en/center/searching?hsLang=en#simple-search) - [Power Search](https://help.northdata.com/en/center/searching?hsLang=en#power-search) - [Sources & Register](https://help.northdata.com/en/center/sources-register?hsLang=en#main-content) - [General Information](https://help.northdata.com/en/center/sources-register?hsLang=en#general-information) - [Germany](https://help.northdata.com/en/center/sources-register?hsLang=en#germany) - [France](https://help.northdata.com/en/center/sources-register?hsLang=en#france) - [Austria](https://help.northdata.com/en/center/sources-register?hsLang=en#austria) - [Netherlands](https://help.northdata.com/en/center/sources-register?hsLang=en#netherlands) - [Czech Republic](https://help.northdata.com/en/center/sources-register?hsLang=en#czech-republic) - [Romania](https://help.northdata.com/en/center/sources-register?hsLang=en#romania) - [Israel](https://help.northdata.com/en/center/sources-register?hsLang=en#israel) - [Denmark](https://help.northdata.com/en/center/sources-register?hsLang=en#denmark) - [Sweden](https://help.northdata.com/en/center/sources-register?hsLang=en#sweden) - [Ireland](https://help.northdata.com/en/center/sources-register?hsLang=en#ireland) - [Norway](https://help.northdata.com/en/center/sources-register?hsLang=en#norway) - [Croatia](https://help.northdata.com/en/center/sources-register?hsLang=en#croatia) - [Company Profile](https://help.northdata.com/en/center/company-profile?hsLang=en#main-content) - [Data Update](https://help.northdata.com/en/center/company-profile?hsLang=en#data-update) - [Person Data](https://help.northdata.com/en/center/company-profile?hsLang=en#person-data) - [Company Data](https://help.northdata.com/en/center/company-profile?hsLang=en#company-data) - [Address Data](https://help.northdata.com/en/center/company-profile?hsLang=en#address-data) - [Industry Classification](https://help.northdata.com/en/center/company-profile?hsLang=en#industry-classification) - [Financial Indicators](https://help.northdata.com/en/center/company-profile?hsLang=en#financial-indicators) - [Data Protection](https://help.northdata.com/en/center/data-protection?hsLang=en#main-content) - [General Information](https://help.northdata.com/en/center/data-protection?hsLang=en#general-information) - [Data Processing](https://help.northdata.com/en/center/data-protection?hsLang=en#data-processing) - [Rights & Protection Options](https://help.northdata.com/en/center/data-protection?hsLang=en#rights-protection-options) - [Glossary](https://help.northdata.com/en/center/glossary?hsLang=en#main-content) - [Classification](https://help.northdata.com/en/center/glossary?hsLang=en#classification) - [Identifiers](https://help.northdata.com/en/center/glossary?hsLang=en#identifiers) - [Key Performance Indicators](https://help.northdata.com/en/center/glossary?hsLang=en#key-performance-indicators) - [Status & Events](https://help.northdata.com/en/center/glossary?hsLang=en#status-events) - [Legal Forms & Organisation](https://help.northdata.com/en/center/glossary?hsLang=en#legal-forms-organisation) - [Ownership & Flags](https://help.northdata.com/en/center/glossary?hsLang=en#ownership-flags) - [Market Intelligence](https://help.northdata.com/en/center/glossary?hsLang=en#market-intelligence) North Data Help Center Copyright © 2025, North Data GmbH