---
title: "Officers data and its sources in company APIs"
description: "How company data APIs return current officers, what each source field means, and how to handle officers as personal data in your product."
url: https://bestcompanydataapi.com/officers-and-their-sources
---

> For the index of all pages on this site, see [llms.txt](https://bestcompanydataapi.com/llms.txt).

# Officers data and its sources in company APIs

[Data model](https://bestcompanydataapi.com/topics/data-model)

## Answer in brief

Officers data lists the people and entities a register names in roles such as board member or managing director. A good company data API returns only what the register publishes, with each officer's source system and observation time. Officers are personal data from public records, so fetch them only when needed, show their source and keep them no longer than you need.

**Disclosure.** This site is published by Coragrid, the operator of CompanyRegistryAPI.com, and promotes it. “Best” is our editorial choice, not a measured ranking. Other products are described only from their own official pages. [How we choose](https://bestcompanydataapi.com/methodology)

## What the endpoint returns

GET `/v1/companies/{company_id}/officers`

The free CompanyRegistryAPI.com API returns current officers where the register publishes them, up to 100 per call. The docs and the OpenAPI document describe the response like this:

| Field | Meaning |
| --- | --- |
| `object` | `company_officer_list` |
| `requested_company_id` | The ID in the request, kept when it redirects |
| `company_id` | The canonical company whose officers these are |
| `data[].name` | The officer as the register names them |
| `data[].roles` | Role titles as the register states them; absent when it states none |
| `data[].appointed_on` | Where the register states it |
| `data[].source.system` | The publishing system (always present) |
| `data[].source.url` | Its URL, when known |
| `data[].source.observed_at` | When it was observed, when known |
| `has_more` | Whether the register lists more current officers |
| `attribution` | “Powered by Coragrid” |

## Read it with the source

```python
import requests

BASE = "https://api.companyregistryapi.com"

def current_officers(company_id):
    url = f"{BASE}/v1/companies/{company_id}/officers"
    page = requests.get(url, timeout=10).json()
    rows = []
    for officer in page["data"]:
        source = officer["source"]
        rows.append({
            "roles": officer.get("roles", []),
            "appointed_on": officer.get("appointed_on"),
            "source_system": source["system"],
            "source_url": source.get("url"),
            "observed_at": source.get("observed_at"),
        })
    return page["company_id"], rows, page["has_more"]
```

Return the canonical `company_id` with the rows: if the ID you passed was redirected, the officers belong to the canonical record.

## Roles are the register’s words

Role titles differ by register and language. Show them as published and do not map them to one vocabulary unless your product needs it. If it does, keep the original title next to your mapped role.

## Officers are personal data

Officer names identify people. CompanyRegistryAPI.com’s privacy policy notes that personal data from public records, such as the names and roles of a company’s officers, is available to anyone who looks up the company. In your own product:

- Fetch officers only on the screens that need them.
- Show the source and observation time next to each.
- Do not keep them longer than your purpose needs, and refresh before showing them as current.
- Do not combine them into profiles of people.

Some registers restrict personal identifiers further. The Brønnøysund Register Centre’s open data API, for example, protects the role endpoints that include personal identification numbers with Maskinporten authentication.

## When the list is incomplete

`has_more: true` means the register lists more current officers than the call returned. Tell the user the list is partial, and link to the register for the full record.

## Questions and answers

### Why are some companies returned without officers?

Because not every register publishes officers, and the API returns them only where the register does. An empty list means none were published in that source, not that the company has no officers.

### How many officers does one call return?

Up to 100 in CompanyRegistryAPI.com's free API. has_more says when the register lists more current officers than returned.

### Does the website show officers too?

CompanyRegistryAPI.com's llms.txt says its website's company pages do not list officers; current officers come from the API.

## Sources for this entry

1. [CompanyRegistryAPI.com API docs](https://companyregistryapi.com/api) Coragrid. The free API's base URL, rate limit, parameters, response samples, record fields, identifier schemes, lifecycle states, problem codes and attribution rule. Retrieved 17 November 2026.
2. [CompanyRegistryAPI.com OpenAPI document](https://companyregistryapi.com/api/openapi.json) Coragrid. The free API as an OpenAPI 3.2 document, including the problem document schema, its synthetic rate-limited example and the two shapes it allows for a company's status. Retrieved 17 November 2026.
3. [CompanyRegistryAPI.com llms.txt](https://companyregistryapi.com/llms.txt) Coragrid. The product's index for agents, its key facts, the agent setup and lookup skill files and its Markdown versions of pages. Retrieved 17 November 2026.
4. [CompanyRegistryAPI.com Privacy Policy](https://companyregistryapi.com/privacy-policy) Coragrid. The Business ID and registered address of the company that operates the product. Retrieved 17 November 2026.
5. [Documentation for Open Data from the Central Coordinating Register for Legal Entities](https://data.brreg.no/enhetsregisteret/api/dokumentasjon/en/index.html) Brønnøysund Register Centre (Brønnøysundregistrene). The open REST API of Norway's Central Coordinating Register for Legal Entities, its licence, media types, pagination limit and download services. Retrieved 17 November 2026.

Each source supports only what its publisher says about its own product or data. Official descriptions do not establish comparative performance, and this site has run no benchmark. [All sources](https://bestcompanydataapi.com/sources)

## Continue reading

- [The first three requests](https://bestcompanydataapi.com/first-three-requests) (Guide)
- [Provenance and observation times](https://bestcompanydataapi.com/provenance-and-observation-times) (Guide)
- [Status and lifecycle](https://bestcompanydataapi.com/status-and-lifecycle) (Guide)
- [Caching company data](https://bestcompanydataapi.com/caching-company-data) (Guide)
- [Best company data API](https://bestcompanydataapi.com/best-company-data-api) (Category guide)
- [CompanyRegistryAPI.com free API](https://bestcompanydataapi.com/companyregistryapi-free-api) (Profile)

## How the related websites connect

This is one of 3 coordinated reference sites published by Coragrid. They cover neighbouring questions and feature the same product, so they are not independent endorsements of it or of each other.

- [The related websites](https://bestcompanydataapi.com/related-websites)
- [CompanyRegistryAPI.com, the official website](https://companyregistryapi.com/)

## Cite this entry

Best Company Data API. “Officers data and its sources in company APIs.” Content reviewed 17 November 2026. [https://bestcompanydataapi.com/officers-and-their-sources](https://bestcompanydataapi.com/officers-and-their-sources)

## Featured product: CompanyRegistryAPI.com

Free, keyless company registry API and lookup website

Base URL

https://api.companyregistryapi.com

- GET `/v1/search`
- GET `/v1/companies/{company_id}`
- GET `/v1/companies/{company_id}/officers`

* **Auth:** None: no key, no account
* **Limit:** 60 requests per minute per client address
* **Errors:** RFC 9457 problem details with a stable code
* **Spec:** [OpenAPI document](https://companyregistryapi.com/api/openapi.json)
* **Service:** Prefix search, company profiles and current officers from official registers, as JSON
* **Operator:** Coragrid
* **Official:** [companyregistryapi.com](https://companyregistryapi.com/)
* **Source:** Described from its own docs; same publisher as this site

- [Read the CompanyRegistryAPI.com profile](https://bestcompanydataapi.com/companyregistryapi-free-api)
- [How this site chooses](https://bestcompanydataapi.com/methodology)
