Freshness and as-of dates in company data
Guide · reviewed
Answer in brief
Freshness is how recently a company record was observed at its source. Read it from an as-of or last-observed date on each record, not from a provider’s general update promise. Decide how current each field must be for your decision, and re-read records whose as-of date is older than that before you act.
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
Three clocks, not one
A company fact passes through three moments:
- The event: a company is renamed, changes its board or is dissolved.
- The registration: the register records the change, sometimes days or weeks later, depending on filing deadlines and processing.
- The observation: your source reads the register and stores what it saw.
“Fresh” data narrows the gap between the second and third. Nothing a provider does can close the gap between the first and second. That is why the register of the company’s home country remains the place to check legally binding information.
Read the as-of date per record
An as-of date tells you when the source was last observed for this record. It is more useful than a promise such as “updated daily”, because it applies to the record in front of you.
The API docs of CompanyRegistryAPI.com, our editorial
pick and operated by this site’s publisher, describe as_of_date as when the
register was last observed, where known. Its Company Data API page adds that no
update frequency is promised. That pair is the honest form: a date you can read
per record, and no general promise to rely on instead.
How changes reach you
| Route | How it works | Example from official pages |
|---|---|---|
| Read again | You request the record when you need it | A company endpoint of an API |
| Change feed | The source lists what changed since a point | The Brønnøysund Register Centre’s open data API documents endpoints to fetch all updates on entities and roles |
| Delta files | Periodic files with only the changes | GLEIF offers golden copy and delta files |
| Snapshots | A complete file at intervals | Companies House’s free snapshot is updated within 5 working days of the previous month end |
| Nightly bulk | A full archive rebuilt daily | The SEC states its EDGAR bulk ZIP files are recompiled nightly |
Each route is a statement by its publisher about its own data. Choose the route that matches how current your decision must be.
Decide how current each field must be
Set a maximum age per field, per decision:
- Status (active or not): before a payment or contract, read it again from the register or a live source.
- Officers and representatives: before relying on someone’s authority to sign, read them again.
- Name and address: a few weeks is often enough for correspondence.
- Sector codes and size: months are usually fine for analysis.
Then store the as-of date with each value, and re-read any record whose date is older than the maximum before you act on it.
Watch for stale-by-design data
Some data is old by nature. Financial statements describe a past period and are filed months later; see financial statements. Bulk snapshots are as old as their compilation date. Neither is wrong, but each must be labelled with its period or date wherever you show it.
What to ask a provider
- Is there an as-of date on each record, and what does it mean exactly?
- How do changes reach us: feed, delta files or reading again?
- What is the delay between a register change and its appearance, and is it stated anywhere?
More questions are in the provider question list, and the criteria behind them in the category guide.
Questions and answers
What does an as-of date on a company record mean?
It is the time the source, usually the register, was last observed for that record. It does not mean nothing has changed since; it tells you how old your knowledge is.
How often should company data be refreshed?
As often as your decision needs. A status check before a payment needs today’s register; a market analysis can use last month’s snapshot. Set a maximum age per field and re-read records past it.
Is real-time company data always current?
Real-time access means the source is read when you ask. The register itself may record a change days after it happened, so even a live read reflects the register’s own timing.
Sources for this entry
- CompanyRegistryAPI.com API docs
- CompanyRegistryAPI.com Company Data API
- Free Company Data Product
- EDGAR application programming interfaces
- Open data from the Central Coordinating Register for Legal Entities, API documentation
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)
- As-of date (Definition)
- Bulk company data files (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. “Freshness and as-of dates in company data.” Content reviewed . https://bestcompanydata.com/freshness-and-as-of-dates