---
title: "Company records and fields a register may not publish"
description: "What a company record from a company data API contains, why fields differ by register, and how to model absent, unknown and restricted values in your code."
url: https://bestcompanydataapi.com/company-records-and-missing-fields
---

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

# Company records and fields a register may not publish

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

## Answer in brief

A company record holds what the source register publishes, and registers publish different things. In a well-designed company data API a field the register does not publish is absent, not estimated. Your code should treat almost every field as optional, tell absent from unknown, and never fill a gap with a guess.

**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 a record contains

The free CompanyRegistryAPI.com API returns a company in `data`. Only `id`, `object` and `lifecycle` are required; every other field appears when available. Its docs describe these fields:

| Field | What it holds |
| --- | --- |
| `id` | The permanent company ID |
| `lifecycle` | Whether this record is current |
| `name` | The name as the register publishes it |
| `country_code` | The address country, ISO 3166-1 alpha-2 |
| `company_status` | A category (active, inactive, unknown) and the register’s own wording |
| `company_type` | The register’s own type code or label |
| `legal_form` | The legal form as the register publishes it, in its own language |
| `branch` | `true` or `false` as the register classifies the record; absent when it does not |
| `as_of_date` | When the register was last observed, where known |
| `identifiers` | Registry identifiers the sources list |
| `classifications` | Current activity codes in their source scheme, codes kept verbatim |
| `register_check` | The check of this record with its register |

## Why fields differ

Each register decides what it publishes. A register may leave out legal form, branches or activity codes, and some data is withheld by law or policy. The Finnish PRH’s open data, for example, says its company interface does not include private traders or companies’ email addresses and phone numbers.

An API that combines registers has two honest choices for a missing value: leave the field out, or mark it as unknown or restricted. CompanyRegistryAPI.com says it does not add, correct or infer facts: values are what the register published, or explicitly unknown, restricted or no longer current.

## Model optional fields explicitly

In TypeScript, let the type say which fields can be missing:

```typescript
type Company = {
  id: string;
  object: "company";
  lifecycle: { status: string; canonical_id?: string; successor_ids?: string[] };
  name?: string;
  country_code?: string;
  // An object; the OpenAPI document still allows the older plain string.
  company_status?:
    | { category: "active" | "inactive" | "unknown"; local_name?: string }
    | string;
  company_type?: string;
  legal_form?: string;
  branch?: boolean;
  as_of_date?: string;
};
```

In Python, read with `.get()` and keep the absence visible:

```python
legal_form = company.get("legal_form")  # None means: not published
label = legal_form if legal_form is not None else "Not published by the register"
```

## Do not fill gaps

Filling gaps creates facts nobody published:

- Do not translate `legal_form` into another country’s forms.
- Do not map activity codes to another scheme unless the source does; the product keeps codes verbatim with no inferred crosswalk.
- Do not default `branch` to `false`. Absent means the register does not classify the form.
- Do not show an empty status as “active”.

## Show the gap in the interface

Write “Not published by the register” rather than a dash, so users know the gap is in the source, not in your software. Next to it, show the record’s `as_of_date` and the attribution line.

## Read the record with its date

A record is a snapshot of what the register said when it was last observed. The [provenance and observation times](https://bestcompanydataapi.com/provenance-and-observation-times) guide covers how to keep that date with every fact you store.

## Questions and answers

### Why is legal_form missing for some companies?

Because the register behind that record does not publish it, or the API has no value for it. A field the register does not publish is absent, never estimated, in CompanyRegistryAPI.com's docs.

### Should I store absent fields as null?

Store them as absent or null, but keep the meaning "not published" separate from "published as empty". Never replace them with a default such as "Ltd" or "active".

### Is company_type the same across countries?

No. CompanyRegistryAPI.com describes company_type as the register's own type code or label, so values differ between registers. Compare types only within one register.

## 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. [About CompanyRegistryAPI.com](https://companyregistryapi.com/about) Coragrid. Where the product's records come from, what it does not do with them, and the free API terms, including "provided as is". Retrieved 17 November 2026.
4. [CompanyRegistryAPI.com Company Data API](https://companyregistryapi.com/company-data-api) Coragrid. How the product describes company IDs and registry identifiers, where its data comes from, what it does not offer and how the data may be used. Retrieved 17 November 2026.
5. [About the PRH open data service](https://avoindata.prh.fi/en/info/swagger-ui) Finnish Patent and Registration Office (PRH). The PRH open data service's charges, update frequency, format and licence, and what its company interface leaves out. 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

- [Provenance and observation times](https://bestcompanydataapi.com/provenance-and-observation-times) (Guide)
- [Status and lifecycle](https://bestcompanydataapi.com/status-and-lifecycle) (Guide)
- [Identifiers and jurisdictions](https://bestcompanydataapi.com/identifiers-and-jurisdictions) (Guide)
- [Store permanent IDs](https://bestcompanydataapi.com/store-permanent-ids) (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. “Company records and fields a register may not publish.” Content reviewed 17 November 2026. [https://bestcompanydataapi.com/company-records-and-missing-fields](https://bestcompanydataapi.com/company-records-and-missing-fields)

## 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)
