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.txtsays values are what the register published, or explicitly unknown, restricted or no longer current. - Status categories include unknown. The same docs give
company_statusa 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
- CompanyRegistryAPI.com llms.txt
- CompanyRegistryAPI.com API docs
- CompanyRegistryAPI.com: Free Company Registry API
- About CompanyRegistryAPI.com
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
- What best company data means (Category guide)
- Provenance on every fact (Guide)
- Reading coverage claims (Guide)
- Testing accuracy on a sample (Guide)
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