Quality

Unknown, absent and restricted values in company data

Guide · reviewed

Answer in brief

An empty field in company data can mean the value is unknown, the register does not publish it, it is restricted, or it is no longer current. Good sources keep these apart and never fill a gap with an estimate. Store the reason with the gap, and never read a missing value, or a missing company, as proof that something does not exist.

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

Four meanings of an empty field

State What it means Example
Unknown The value exists in the world, but the source does not know it A register publishes a status, but this record has none
Absent The register does not publish this kind of value A register that publishes no officers
Restricted The value exists but is withheld, by law or policy A record withheld from public view
No longer current The value was true once and has ended A former registry number or a past officer

A source that turns all four into the same blank, or worse fills them with a guess, takes a decision away from you. A source that keeps them apart lets you decide what each gap means for your job.

How a source can keep them apart

Look in the documentation for explicit statements:

  • Absent fields are left out, not estimated. The API docs of CompanyRegistryAPI.com, our editorial pick and operated by this site’s publisher, state that a field the register does not publish is absent, never estimated. Its llms.txt says values are what the register published, or explicitly unknown, restricted or no longer current.
  • Status categories include unknown. The same docs give company_status a category of active, inactive or unknown, next to the register’s own wording.
  • Former values are marked. A registry identifier’s status can be ended, and an ended number is a former number, never a current one.
  • Restricted records say so. A record’s lifecycle can be restricted, and such a record may answer with its lifecycle and no registry fields.

The product’s home page sums this up as unknown, conflicting, restricted and unavailable data staying distinguishable. Ask other providers for the same kind of statement in writing.

The missing company

The most consequential gap is a company that is not found. A source can miss a company because its register is not connected, because the company is of a type the source does not hold, because the search input did not match, or because the record is restricted. CompanyRegistryAPI.com states that coverage depends on the registers Coragrid has connected and qualified, and that a missing company is not evidence that it does not exist.

In practice:

  • Never reject a customer, supplier or applicant only because a data source returned nothing.
  • Try another input: the registry number instead of the name, or the legal name instead of the trading name.
  • Check the register of the company’s home country. For legally binding information, that register is the place to look.

Storing gaps honestly

Give each gap a reason in your own data model:

officers: null
officers_reason: "not_published_by_register"
officers_checked_at: "2026-11-17"

Then your interface can say “not published by the register” instead of “none”, and your analysts will not count a gap as a zero.

Showing gaps to users

  • Say why a value is missing, in plain words.
  • Never show “0”, “none” or “no directors” for an unknown value.
  • Show the date the source was checked, as the freshness guide recommends.

Testing gaps in a pilot

Include in your pilot companies you know to have restricted data, dissolved companies and companies from a register that publishes few fields. See whether each source tells you why a value is missing. The accuracy guide counts a filled guess as an error, not as coverage.

Gap handling is part of provenance in the category guide.

Questions and answers

Does an empty officers list mean a company has no directors?

No. It may mean the register does not publish officers, the source has not connected that part of the register, or the data is restricted. Check the source’s documentation for what the field means when empty.

Is it bad if a company data source leaves fields empty?

Not in itself. An honest gap is better than a plausible estimate. What matters is whether the source says why the field is empty.

What does it mean if a company is not found at all?

Only that the source did not return it. It may be outside the source’s coverage, spelled differently or restricted. Check the official register of the company’s home country before concluding anything.

Sources for this entry

  1. CompanyRegistryAPI.com llms.txt Coragrid. The product’s own summary for agents, its Markdown versions of pages, its Agent Skill and its OpenAPI document. Retrieved 17 November 2026.
  2. CompanyRegistryAPI.com API docs Coragrid. The free API’s base URL, endpoints, rate limit, record fields, identifier schemes, lifecycle states, problem codes and attribution rule. Retrieved 17 November 2026.
  3. CompanyRegistryAPI.com: Free Company Registry API Coragrid. What the product is, its key features, the 71 countries it lists as coverage and its statement on gaps. Retrieved 17 November 2026.
  4. About CompanyRegistryAPI.com Coragrid. Where the product’s records come from, what it does not do with them, its statement on coverage and the free API terms. 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

Continue reading

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.

Cite this entry

Best Company Data. “Unknown, absent and restricted values in company data.” Content reviewed . https://bestcompanydata.com/unknown-absent-restricted-values