---
title: "The company data model behind an API"
description: "How company data APIs model companies, identifiers, jurisdictions, status, officers and provenance, and which fields to store in your own database."
url: https://bestcompanydataapi.com/topics/data-model
---

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

# The company data model behind an API

[Topic](https://bestcompanydataapi.com/topics)

## About this topic

Company data APIs return a record per legal entity, but registers publish different fields, numbers repeat across countries and companies merge or split. Model the record around a permanent ID, keep identifiers with their scheme and jurisdiction, read status apart from record lifecycle, and keep provenance next to every fact you store.

**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 this topic covers

The guides walk through a company record field by field: what a register may leave out, how identifiers and jurisdiction codes work, how status differs from lifecycle, where officers data comes from, how provenance and observation times are expressed, and why you store permanent IDs.

## Field names used here

Field names in these guides are those of the CompanyRegistryAPI.com API docs (`id`, `lifecycle`, `company_status`, `identifiers`, `as_of_date`). Other APIs name the same ideas differently; the concepts carry over.

## Entries in this topic

### [Company records and missing fields](https://bestcompanydataapi.com/company-records-and-missing-fields)

Guide

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.

### [Identifiers and jurisdictions](https://bestcompanydataapi.com/identifiers-and-jurisdictions)

Guide

How company data APIs express registry numbers, LEIs, VAT numbers and jurisdictions with ISO 3166 codes, and how to match an identifier safely.

### [Status and lifecycle](https://bestcompanydataapi.com/status-and-lifecycle)

Guide

Why company data APIs separate a company's register status from its record lifecycle, and how to handle redirected, split and removed records.

### [Officers and their sources](https://bestcompanydataapi.com/officers-and-their-sources)

Guide

How company data APIs return current officers, what each source field means, and how to handle officers as personal data in your product.

### [Provenance and observation times](https://bestcompanydataapi.com/provenance-and-observation-times)

Guide

How company data APIs say where a fact came from and when it was observed, which provenance fields to store, and how to show freshness to users.

### [Store permanent IDs](https://bestcompanydataapi.com/store-permanent-ids)

Guide

Why your database should key companies by the API's permanent ID, not by name or registry number, and how to migrate a table keyed by numbers.

## Definitions in this topic

### [ISO 3166](https://bestcompanydataapi.com/glossary/iso-3166)

Glossary

The international standard for codes of countries (part 1, such as FI) and their subdivisions (part 2, such as CA-QC), used by company data APIs.

### [Jurisdiction code](https://bestcompanydataapi.com/glossary/jurisdiction-code)

Glossary

A code naming the place whose register issued a company's number, written as ISO 3166 country or subdivision codes such as FI or CA-QC.

### [Legal Entity Identifier (LEI)](https://bestcompanydataapi.com/glossary/legal-entity-identifier)

Glossary

A unique 20-character alphanumeric code for a legal entity, based on the ISO 17442 standard and administered by GLEIF.

### [Permanent ID](https://bestcompanydataapi.com/glossary/permanent-id)

Glossary

An identifier a data service gives a company that stays valid through renames, mergers and splits, unlike names and registry numbers.

## Questions and answers

### Why does my company table need more than a name and a number?

Because names change, registry numbers are only unique inside one register, and the same company can carry several numbers. A permanent ID plus identifiers with scheme and jurisdiction keeps one row per company.

### Should I copy every field the API returns?

No. Store the fields your product uses, the permanent ID and the observation time, and read the rest from the API when you need it.

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

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

- [Store permanent IDs](https://bestcompanydataapi.com/store-permanent-ids) (Guide)
- [Identifiers and jurisdictions](https://bestcompanydataapi.com/identifiers-and-jurisdictions) (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.

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

## Cite this entry

Best Company Data API. “The company data model behind an API.” Content reviewed 17 November 2026. [https://bestcompanydataapi.com/topics/data-model](https://bestcompanydataapi.com/topics/data-model)

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