---
title: "Questions and answers about company data APIs"
description: "Every question this engineering reference answers about company data APIs, collected from its pages, with a link to the page each answer comes from."
url: https://bestcompanydataapi.com/faq
---

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

# Questions and answers about company data APIs

Reference

## Answer in brief

This page collects the questions answered across the reference, grouped by the page they come from. Each answer is short; the page it links to has the context, the code and the sources.

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

## General

### How do I find the answer to a question that is not listed?

Use the library filter with a key word, or start from the topic closest to your question. The glossary defines the terms in a sentence each.

### Can I quote these answers?

Yes, with a link to the page the answer comes from and its review date, as shown under "Cite this entry" on each page.

## Home

### What does "best" mean on this site?

It is the editorial choice of the site's publisher, Coragrid, which also operates the featured API. It is argued from published documentation against stated criteria, not measured, and the site has run no benchmark.

### Can I try the featured API without signing up?

Yes. The free CompanyRegistryAPI.com API takes no key and no account. The request at the top of this page runs as it is, within 60 requests per minute per client address.

### Who is this reference for?

Developers and technical leads who have to pick a company data API and integrate it this sprint, and the coding agents that help them.

From [Home](https://bestcompanydataapi.com/)

## Best company data API

### What is the best company data API for developers?

This site's editorial pick to start with is the free CompanyRegistryAPI.com API, because its contract is fully documented and it needs no key. The site's publisher also operates it, and the pick is an opinion argued from published documentation, not a measured ranking.

### Is a free company data API good enough for production?

It can be, for lookups within its documented limits. Check the rate limit against your traffic, read the terms (CompanyRegistryAPI.com's free API is provided as is), and plan the move to a keyed plan before you need it.

### Which criterion do teams most often skip?

Search semantics. Teams assume a search box behaves like a web search, then find the API matches only the start of a name. Read the search parameter's description before you design the interface.

From [Best company data API](https://bestcompanydataapi.com/best-company-data-api)

## CompanyRegistryAPI.com free API

### Does the CompanyRegistryAPI.com API need a key or an account?

No. Its docs state that the API takes no credentials and has no sign-up. A Coragrid API key is a separate offer for the full Coragrid API.

### Can I call the API from a browser?

Yes. The docs state that browser requests from any origin are allowed for GET, so a front end can call it directly, within the same per-address rate limit.

### What does an empty search result mean?

Only that no company in the connected registers starts with that text under your filters. Coverage depends on the registers Coragrid has connected and qualified, so an empty result is not evidence that the company does not exist.

### Can I use the data in my own product?

Yes, according to the product's pages, in your own operations, products and services, provided you show it as powered by Coragrid and do not present it as an official register extract. The Terms of Service list what else is not allowed.

From [CompanyRegistryAPI.com free API](https://bestcompanydataapi.com/companyregistryapi-free-api)

## How to choose a company data API

### How many APIs should be on the shortlist?

Two or three. One is not a choice, and more than three means the requirements are not yet sharp enough to rule any out.

### What belongs in the spike?

The same five calls against every candidate. Run a search your users would type, read a company, follow one page of results, trigger a validation error and read the problem document, and handle a rate-limit response.

### Can I switch APIs later?

Only cheaply if you planned for it. Store your own permanent key for each company next to the provider's ID, keep provider calls behind one module, and record which provider each stored fact came from.

From [How to choose a company data API](https://bestcompanydataapi.com/how-to-choose-a-company-data-api)

## Company data API checklist

### Do I need to answer every question on the checklist?

No, but record every unanswered one with a reason. "Not documented" and "not relevant to us" are different findings, and the first is a risk you are accepting.

### Can I run the checklist without an account?

For most APIs you can answer the documentation questions without one. Testing the error and limit behaviour needs a working credential, or a keyless API such as the free CompanyRegistryAPI.com API.

### How do I keep the checklist results useful later?

Store the filled-in copy next to the integration code, with the date and the documentation links, so whoever revisits the choice can see what was true when it was made.

From [Company data API checklist](https://bestcompanydataapi.com/company-data-api-checklist)

## Reading an OpenAPI document

### Which OpenAPI version should a company data API publish?

Any current 3.x document is workable. CompanyRegistryAPI.com publishes an OpenAPI 3.2 document; older 3.0 documents, such as the one ARES publishes, read the same way for these purposes.

### Should I generate a client from the OpenAPI document?

For a small API, a hand-written client of a few functions is often clearer. Generate one when the API has many endpoints or when you want types checked against the schema.

### What if the API has no OpenAPI document?

Then the contract lives only in prose, and drift between docs and behaviour is harder to spot. Record that in your evaluation and test the error responses yourself.

From [Reading an OpenAPI document](https://bestcompanydataapi.com/reading-an-openapi-document)

## Free tiers and rate limits

### What does "per client address" mean for my servers?

The limit applies to the address your requests come from. All requests from one server or one outbound gateway share a single allowance, so a fleet behind one address gets no more than one browser would.

### Is 60 requests per minute enough?

It is enough for interactive lookups where each user action makes one or two calls, and for batch jobs of a few thousand companies spread over an hour. It is not enough to refresh tens of thousands of records quickly.

### Do failed requests count against the limit?

Assume they do unless the documentation says otherwise. Retrying without a delay spends the budget on requests that fail again.

From [Free tiers and rate limits](https://bestcompanydataapi.com/free-tiers-and-rate-limits)

## Keyless, key and OAuth access

### Is a keyless API less secure?

Not for reading public register data. There is no secret to leak, and the provider limits use per client address instead. It does mean you cannot get a higher allowance by identifying yourself.

### Can I put an API key in front-end code?

No. Anything shipped to a browser is public. Call a keyed API from your server, or use a keyless API that allows browser requests.

### Where should an API key live?

In a secret store, injected into the process environment at run time, or in the operating system keyring on a developer machine. Never in a repository, a shell profile or a conversation with an AI agent.

From [Keyless, key and OAuth access](https://bestcompanydataapi.com/keyless-key-and-oauth-access)

## Terms, attribution and "as is"

### Does "provided as is" mean I cannot use the API in production?

No. It means the provider makes no promise about fitness or availability. Many teams use such APIs in production behind caching, monitoring and a documented fallback.

### Where should the "Powered by Coragrid" line go?

Wherever you display the data, according to CompanyRegistryAPI.com's docs. In practice that means next to the company details in your interface, not only on a separate credits page.

### Can I present API data as an official register extract?

Not with CompanyRegistryAPI.com, whose pages say not to. For legally binding information, they direct readers to the register of the company's home country.

From [Terms, attribution and "as is"](https://bestcompanydataapi.com/terms-attribution-and-as-is)

## The first three requests

### Why not take the first search result?

Results come in registry name order with no relevance score, so the first result is only the alphabetically first match. Confirm the registry number, scheme and jurisdiction in the company read before you store the ID.

### I already have the registry number. Do I still search?

Yes, but search by the number itself, which the API accepts as q. Then read the company and confirm the number appears in identifiers with the scheme and jurisdiction you expect and a status other than ended.

### Why are officers a separate call?

The company read returns registry facts; officers come from a separate endpoint so you only fetch them when you need them. Each officer names the system that published it.

From [The first three requests](https://bestcompanydataapi.com/first-three-requests)

## Pagination with cursors

### Can I decode or build a cursor myself?

No. Treat it as opaque, because its format can change without notice. Store it only for as long as you are paging, and pass it back exactly as received.

### Should I page through every search result?

Rarely. Company search is for finding candidates; if your code pages through thousands of results, it usually needs a narrower query, a filter or a bulk data source.

### Why did my cursor stop working after a few minutes?

Cursors expire. CompanyRegistryAPI.com documents that cursors expire and that on a 400 you restart from the first page, so write the restart into the loop.

From [Pagination with cursors](https://bestcompanydataapi.com/cursor-pagination)

## Handling 429 and Retry-After

### Can Retry-After be a date instead of seconds?

RFC 9110 allows either an HTTP date or a number of seconds. CompanyRegistryAPI.com's OpenAPI document describes it as an integer number of seconds, but a general client should accept both.

### How many times should I retry?

Three or four attempts in total is enough for interactive requests. For batch jobs, slow the whole job down instead of retrying one request many times.

### Should I retry a 400 invalid_request?

No. The request itself is wrong, so it will fail again. Fix the parameter that the problem document's detail names.

From [Handling 429 and Retry-After](https://bestcompanydataapi.com/handling-429-and-retry-after)

## Caching company data

### How long should I cache a company record?

Choose by what the fact is used for. A name shown in a list can live for days; a status used to approve a payment should be re-read close to the decision. The record's own observation date tells you how old the register fact already was.

### Should I cache empty search results?

Briefly at most. An empty result only means no connected register held a match for that prefix, and coverage can change, so never treat a cached empty result as proof that a company does not exist.

### Can I cache officers?

You can, but officers are personal data from public records. Keep them only as long as your product needs them, with their source, and refresh them before showing them as current.

From [Caching company data](https://bestcompanydataapi.com/caching-company-data)

## Problem details and error codes

### Should my code branch on the HTTP status or on the code?

On the code. Several codes share a status, such as upstream_busy and upstream_unavailable, which are both 503, and only the code tells them apart.

### Can I show the detail text to users?

Show it to developers and in logs. For end users, map the code to your own message, because detail is written for the person fixing the request.

### What is RFC 7807?

The earlier version of problem details. RFC 9457 obsoletes it and keeps the same media type, so a client written for one works with the other.

From [Problem details and error codes](https://bestcompanydataapi.com/problem-details-and-error-codes)

## Prefix, fuzzy and description search

### Why does a prefix search miss "Robotics Example Oy" when I type "Example"?

Because prefix search matches the start of the name. Unless the register stores another name starting with your text, a word in the middle of the name is not matched.

### Can I build fuzzy search on top of a prefix API?

Only partly. You can try a few variants of the first letters, but each costs a request against the rate limit. Real fuzzy matching needs an API or index that supports it.

### Which search does CompanyRegistryAPI.com offer?

Its free API offers prefix search on a name or business ID, 3 to 64 characters, with no relevance score. Search by description is part of the full Coragrid API, which needs a key.

From [Prefix, fuzzy and description search](https://bestcompanydataapi.com/prefix-fuzzy-and-description-search)

## Company records and missing fields

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

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

## Identifiers and jurisdictions

### What is the difference between address country and jurisdiction?

The address country is where the company's address is; the jurisdiction is where its identifiers are registered. CompanyRegistryAPI.com notes that the two can differ, and offers a separate filter for each.

### Does an LEI have a jurisdiction?

No. An LEI is globally unique under ISO 17442, so CompanyRegistryAPI.com lists it under the scheme lei without a country_scope.

### Why do OpenCorporates' jurisdiction codes look different?

OpenCorporates documents lowercase two-letter country codes and an underscore form of ISO 3166-2 for states and provinces, such as us_mi. Convert between conventions in one function when you use several APIs.

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

## Status and lifecycle

### Is an inactive company dissolved?

Not necessarily. Registers use their own words for many situations. Read the register's own wording in local_name next to the normalised category before you act on it.

### What should I do with a redirected record?

Read the record named in lifecycle.canonical_id and store that ID instead. The ID you asked for stays valid as a pointer, but the current facts are under the canonical record.

### Does a 404 mean the company never existed?

No. A 404 not_found means no company is visible under that ID in the API. CompanyRegistryAPI.com's docs say that neither a 404 nor a removed record is evidence that the company never existed.

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

## Officers and their sources

### Why are some companies returned without officers?

Because not every register publishes officers, and the API returns them only where the register does. An empty list means none were published in that source, not that the company has no officers.

### How many officers does one call return?

Up to 100 in CompanyRegistryAPI.com's free API. has_more says when the register lists more current officers than returned.

### Does the website show officers too?

CompanyRegistryAPI.com's llms.txt says its website's company pages do not list officers; current officers come from the API.

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

## Provenance and observation times

### Is as_of_date the date the company changed?

No. In CompanyRegistryAPI.com's docs, as_of_date is when the register was last observed, where known. It says how fresh the snapshot is, not when the company's facts last changed.

### Does the API promise how often data is updated?

CompanyRegistryAPI.com's pages say no update frequency is promised; the record's as_of_date tells you when the register was last observed. For legally binding information, consult the register of the company's home country.

### Why keep my own fetch time as well?

Because it tells you when your copy was made, which drives refresh and caching. The observation time tells you how old the source fact was at that moment.

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

## Store permanent IDs

### Can I parse or shorten the permanent ID?

No. CompanyRegistryAPI.com describes its company ID as opaque, permanent and never reassigned, and asks you to store it as returned.

### What happens to the ID when companies merge?

The record may be redirected. The ID you stored stays valid, and lifecycle.canonical_id names the record to read and store from then on.

### Will the IDs still work if I move to the paid Coragrid API?

Yes, according to the product's pages. The free API uses the same permanent IDs and field names as the Coragrid public API, so stored IDs stay valid and need no data migration.

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

## MCP and WebMCP

### Which should I offer, an MCP server or WebMCP tools?

An MCP server for agents your users configure in an AI app, WebMCP for agents browsing your pages. CompanyRegistryAPI.com offers both, with the same tool names, inputs and answers.

### Do WebMCP tools need an API key?

Not CompanyRegistryAPI.com's. Its WebMCP page says each call goes from the user's browser to the free API with no key or cookies, within that address's 60 requests a minute.

### Is WebMCP a finished standard?

No. It is published as a draft community group report of the W3C Web Machine Learning Community Group, and browser support depends on origin trials and flags.

From [MCP and WebMCP](https://bestcompanydataapi.com/mcp-and-webmcp)

## llms.txt, skills and Markdown docs

### Does llms.txt replace the OpenAPI document?

No. llms.txt is an index and a summary for language models; the OpenAPI document is the precise contract. A good llms.txt links to the OpenAPI document.

### How do I get the Markdown version of a CompanyRegistryAPI.com page?

Append .md to the page URL, or request the page with Accept set to text/markdown. Its llms.txt says this works for every page except search results.

### Should an agent read the website or call the API?

Call the API. CompanyRegistryAPI.com's llms.txt says agents should call the API rather than read the HTML pages, whose browser search is protected and meant for people.

From [llms.txt, skills and Markdown docs](https://bestcompanydataapi.com/llms-txt-skills-and-markdown-docs)

## Company data from the command line

### Do I need a CLI to use CompanyRegistryAPI.com from a terminal?

No. Its free API needs no key, so curl is enough. The cgd command line is for the full Coragrid API and needs a Coragrid API key.

### How do I keep an API key out of my shell history?

Store it with the tool's login command in the operating system keyring, or inject it into the process environment from a secret store at run time. Do not type it on the command line or write it to a shell profile.

### Can a coding agent use these commands?

Yes. The commands print JSON, which agents read well. Give the agent the free API's contract, for example through the product's lookup skill, and never paste a key into the conversation.

From [Company data from the command line](https://bestcompanydataapi.com/company-data-from-the-command-line)

## Kinds of company data APIs

### Which kind is the primary source?

The official register of the company's home country. Aggregators and the LEI system are derived from or alongside registers, which is why a good aggregator keeps the link to the register for each fact.

### Does every company have an LEI?

No. The GLEIF API serves LEI records, so it can only find legal entities that have obtained an LEI. For other companies, use a register or a multi-register API.

### Is CompanyRegistryAPI.com an aggregator?

It is a free API over the registers Coragrid has connected and qualified, so it belongs with the multi-register APIs. It returns registry facts with their sources and does not add, correct or infer facts.

From [Kinds of company data APIs](https://bestcompanydataapi.com/kinds-of-company-data-apis)

## From a free API to a keyed platform

### What signals that it is time to move?

Sustained 429 responses at peak, users who need fuzzy or description search, batch refreshes that no longer fit in the rate limit, or a need for terms and support that a free, as-is service does not offer.

### Do I need to migrate stored company IDs?

Not when moving from the free CompanyRegistryAPI.com API to the Coragrid API. The product's pages say companies keep their permanent IDs and field names, so what you stored stays valid.

### How do I get a Coragrid API key?

Coragrid issues keys and their scopes on request at coragrid.com/request-access. CompanyRegistryAPI.com has no sign-up form and never asks for a key.

From [From a free API to a keyed platform](https://bestcompanydataapi.com/from-free-api-to-keyed-platform)

## Methodology

### Did you test the APIs in the directory?

No. Third-party APIs are described only from their own official pages. The only API whose requests we ran is the featured one, to check that the examples we publish behave as its docs say.

### Why is the featured product the editorial pick when you operate it?

Because the publisher of this site built it for the use the site describes and stands behind that opinion. The disclosure is on every page so you can weigh the recommendation accordingly.

### How can I report an error?

Write to contact@companyregistryapi.com with the page address and what is wrong. Corrections are dated by the page's review date.

From [Methodology](https://bestcompanydataapi.com/methodology)

## About

### Who writes this site?

Coragrid, the company that operates CompanyRegistryAPI.com. There is no independent editorial board, which is why every page carries the disclosure.

### Is this site independent of CompanyRegistryAPI.com?

No. It has the same publisher and features that product. Read it as the publisher's engineering guide, with the evidence linked so you can check it.

From [About](https://bestcompanydataapi.com/about)

## Topics

### In which order should I read the topics?

Evaluating an API first, then Integration patterns while you build, and The data model before you design your tables. Agents and tooling and The API landscape can be read when you need them.

### Where are the definitions?

Each topic hub lists the glossary terms that belong to it, and the glossary page lists them all.

From [Topics](https://bestcompanydataapi.com/topics)

## Evaluating an API

### How long should evaluating a company data API take?

For a first shortlist, about an hour per API is enough to read the docs, the OpenAPI document and the terms, and to run a search and a company read. Anything you cannot find in that time is itself a finding.

### Should I evaluate the free tier or the paid plan?

Evaluate the tier you will run in production, but start your reading with the free tier when there is one, because it shows the data model and error format without a contract.

From [Evaluating an API](https://bestcompanydataapi.com/topics/evaluating)

## Integration patterns

### Do I need an SDK to integrate a company data API?

Not for a small JSON API. The fetch API in JavaScript or the requests library in Python is enough, and writing the few patterns yourself keeps retry and caching rules visible in your own code.

### Which pattern should I build first?

Error handling. Branching on the problem code and backing off on 429 before you add features saves you from debugging a retry storm later.

From [Integration patterns](https://bestcompanydataapi.com/topics/integration)

## Data model

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

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

## Agents and tooling

### Do agents need a different API from my application?

No. The useful pattern is one HTTP contract with several front doors, so an agent and your backend read the same records with the same IDs.

### What should I check first when an agent will call the API?

Whether the provider documents its agent files and tools, which allowance the agent's calls count against, and how errors such as rate_limited reach the agent.

From [Agents and tooling](https://bestcompanydataapi.com/topics/agents)

## API landscape

### Is an official register API always the better source?

It is the primary source for its own register, which matters for legally binding information. If you need many countries behind one contract, an aggregator saves you one integration per register.

### Where does CompanyRegistryAPI.com fit in this landscape?

It is a free, keyless API over registers that Coragrid has connected and qualified, so it sits with the multi-register APIs. It is the editorial pick of this site, whose publisher also operates it.

From [API landscape](https://bestcompanydataapi.com/topics/landscape)

## API directory

### How were the APIs in the directory chosen?

As examples of each kind of company data API that a developer is likely to meet, limited to those whose official documentation we could open and read on the review date.

### Are the third-party APIs partners of CompanyRegistryAPI.com?

No. Each is a separate resource, not a product of Coragrid and not a partner, and its publisher has not endorsed this site.

### Why are there no prices?

This site quotes a price only when an official page states it, with the date read. None of the pages read on the review date did, so check each provider's own pricing page.

From [API directory](https://bestcompanydataapi.com/directory)

## Coragrid API

### Is the Coragrid API independent of this site?

No. Coragrid operates it, operates CompanyRegistryAPI.com and publishes this site. It is listed here because it is the documented next step from the free API.

### Do I need to migrate data when I get a Coragrid key?

According to the product's key page, no. Companies keep their permanent IDs and field names, so stored IDs stay valid; the transport changes to bearer authentication and a QUERY search request.

From [Coragrid API](https://bestcompanydataapi.com/resources/coragrid-api)

## Companies House API

### How does the Companies House API authenticate?

Its authorisation guide says each request carries an API key, sent through HTTP Basic authentication with the key as the username and an empty password. Some functionality that acts for an end user needs OAuth 2.0.

### What happens over the Companies House rate limit?

Its rate limiting guide says you receive 429 Too Many Requests for each request in the rest of the five-minute window, after which the limit resets to 600.

From [Companies House API](https://bestcompanydataapi.com/resources/companies-house-api)

## GLEIF API

### Does the GLEIF API charge for LEI data?

Its documentation states that there is no charge for the use of GLEIF's LEI data, and that GLEIF does not enter into individual contracts with specific users. It refers users to the LEI Data Terms of Use.

### Can the GLEIF API find companies without an LEI?

No. It serves LEI records and related data, so a company that never obtained an LEI is not in it. Use a register or a multi-register API for those.

From [GLEIF API](https://bestcompanydataapi.com/resources/gleif-api)

## OpenCorporates API

### Which formats does the OpenCorporates API return?

Its reference says it returns JSON by default and XML when you add format=xml to the request.

### How does OpenCorporates identify a company in its API?

By jurisdiction code and company number in the path. Its reference writes a country as its lowercase ISO code and a state or province as an underscore form of the ISO 3166-2 code, such as us_mi.

From [OpenCorporates API](https://bestcompanydataapi.com/resources/opencorporates-api)

## Brønnøysund Register Centre open data API

### How deep can I page through Brønnøysund search results?

Its documentation says (page+1)\*size cannot exceed 10,000; beyond that the service answers 400. For all entities, it points to the download services, which are updated once a day.

### Do all Brønnøysund endpoints work without authentication?

No. Its documentation says some role endpoints, such as those including personal identification numbers, are protected by Maskinporten authentication.

From [Brønnøysund Register Centre open data API](https://bestcompanydataapi.com/resources/brreg-open-data-api)

## PRH open data API

### Is PRH open data free to use in a product?

PRH says its open data is available free of charge under the Creative Commons Attribution 4.0 International licence. You must mention the original source, and services must not use PRH or Finnish Business Information System logos or imitate PRH's services.

### Which financial statements does PRH's interface cover?

Only digital financial statements filed in the iXBRL reporting language, which PRH says represent about 5 per cent of all financial statements. It sells others through its Virre Information Service.

From [PRH open data API](https://bestcompanydataapi.com/resources/prh-open-data-api)

## KVK APIs

### Can I try the KVK APIs without a subscription?

Yes, in the test environment. KVK's portal says you can try its APIs for free with a small set of fictitious data, with no implementation or registration required.

### What does a KVK subscription cost?

KVK's portal says you pay a standard amount per month and a small fee per query, and links to its pricing page. This site does not quote prices; check the current figures there.

From [KVK APIs](https://bestcompanydataapi.com/resources/kvk-api)

## SEC EDGAR APIs

### Do the SEC's EDGAR APIs need a key?

The SEC's page says these APIs do not require any authentication or API keys. Automated access must comply with SEC.gov's Privacy and Security Policy, as its Developer FAQs describe.

### Are the EDGAR APIs a company register?

No. They serve filings data of SEC filers, such as submission history and XBRL financial statements. For a company's registration, use the register of its state or country.

From [SEC EDGAR APIs](https://bestcompanydataapi.com/resources/sec-edgar-apis)

## ARES REST API

### How do I search ARES by company number?

Its OpenAPI document describes GET /ekonomicke-subjekty/{ico}, a lookup of an economic entity by its IČO, the Czech identification number.

### Why is ARES search a POST request?

Its OpenAPI document describes the search as a complex filter sent in a JSON request body to /ekonomicke-subjekty/vyhledat. Treat it as a read even though it uses POST.

From [ARES REST API](https://bestcompanydataapi.com/resources/ares-api)

## Glossary

### Where do the definitions come from?

Standards terms rest on the RFC or specification that defines them. Product terms rest on the documentation of the API that uses them.

### Why are some terms specific to CompanyRegistryAPI.com?

Because its field names, such as next_cursor or country_scope, are used as worked examples throughout the guides. Each definition says where the term is product-specific.

From [Glossary](https://bestcompanydataapi.com/glossary)

## API key

### Does the free CompanyRegistryAPI.com API need an API key?

No. It takes no credentials. A Coragrid API key is only for the full Coragrid API behind it.

### Is an API key the same as a company ID?

No. A key is a credential that identifies your application; a company ID identifies a company in the data. CompanyRegistryAPI.com's docs make the same distinction.

From [API key](https://bestcompanydataapi.com/glossary/api-key)

## Attribution

### Where must CompanyRegistryAPI.com's attribution appear?

Wherever you display the data, according to its docs. Its responses carry the line in an attribution field.

### Is attribution the same as a licence?

No. Attribution is one condition; the licence or terms say what else you may and may not do, such as PRH's ban on using its logos.

From [Attribution](https://bestcompanydataapi.com/glossary/attribution)

## Bearer token

### Why must a bearer token stay secret?

Because whoever has it can use it; no other proof is needed. Store it in a secret store and send it only over HTTPS.

### Which company data API on this site uses bearer authentication?

The Coragrid API. CompanyRegistryAPI.com's key page shows Coragrid API keys sent as "Authorization Bearer" headers.

From [Bearer token](https://bestcompanydataapi.com/glossary/bearer-token)

## Cursor

### What does a null next_cursor mean?

That you are on the last page. CompanyRegistryAPI.com's OpenAPI document says next_cursor is null on the last page.

### How long does a cursor last?

Not forever. CompanyRegistryAPI.com documents that cursors expire and that on a 400 you restart from the first page.

From [Cursor](https://bestcompanydataapi.com/glossary/cursor)

## HTTP 429

### Is a 429 an error in my code?

No. It is the API telling you to slow down. Wait as long as Retry-After says, then retry the same request.

### Which problem code goes with 429 in CompanyRegistryAPI.com?

rate_limited. Its docs say to retry after the number of seconds in Retry-After.

From [HTTP 429](https://bestcompanydataapi.com/glossary/http-429)

## Idempotent request

### Are company lookups idempotent?

Yes. Reading a company with GET is a safe method, and RFC 9110 counts safe methods as idempotent. All three free CompanyRegistryAPI.com endpoints are GET.

### Why does idempotency matter for retries?

Because a retried idempotent request cannot do something twice. Requests that create or change data need more care before you retry them.

From [Idempotent request](https://bestcompanydataapi.com/glossary/idempotent-request)

## ISO 3166

### Which ISO 3166 form does CompanyRegistryAPI.com use?

ISO 3166-1 alpha-2 for the address country, such as FI, and either alpha-2 or ISO 3166-2, such as CA-QC, for the registration jurisdiction.

### Why do I need subdivision codes?

Because some registers work below country level, for example by state or province, and their numbers are only unique there.

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

## JSON

### Do company data APIs all return JSON?

Most do, but check. OpenCorporates returns JSON by default and XML on request, and Brønnøysund serves JSON in HAL format.

### Is problem+json still JSON?

Yes. application/problem+json is JSON with an agreed set of members for errors, defined in RFC 9457.

From [JSON](https://bestcompanydataapi.com/glossary/json)

## Jurisdiction code

### Is the jurisdiction the same as the address country?

Not always. CompanyRegistryAPI.com notes that the address country and the registration jurisdiction can differ, and offers a filter for each.

### Does a country jurisdiction match its subdivisions?

In CompanyRegistryAPI.com's search filter, yes. Its docs say a country code also matches its subdivisions.

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

## Legal Entity Identifier (LEI)

### Where can software look up LEIs?

GLEIF's API serves LEI records, with search by entity name, lookup by BIC code and parent and child relationships, according to GLEIF's page.

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

## MCP

### Does CompanyRegistryAPI.com have an MCP server?

Yes. Its WebMCP page names the MCP server at https://mcp.companyregistryapi.com/mcp, an endpoint you add to an AI app once, with its own allowances.

### How is MCP different from an HTTP API?

An MCP server describes its calls as tools an AI application can discover and call. The data usually comes from an HTTP API behind it.

From [MCP](https://bestcompanydataapi.com/glossary/mcp)

## OpenAPI

### Which version is the CompanyRegistryAPI.com OpenAPI document?

Its docs describe an OpenAPI 3.2 document of the three free endpoints, at companyregistryapi.com/api/openapi.json.

### Is OpenAPI the same as Swagger?

Swagger UI is a common viewer for OpenAPI documents; KVK, for example, links its OpenAPI specifications through Swagger UI.

From [OpenAPI](https://bestcompanydataapi.com/glossary/openapi)

## Permanent ID

### What does a CompanyRegistryAPI.com permanent ID look like?

It starts with co\_. The docs describe it as opaque, permanent and never reassigned, and ask you to store it as returned.

### What happens to a permanent ID when companies merge?

The ID stays valid. Its record may become redirected, with lifecycle.canonical_id naming the record to read instead.

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

## Prefix search

### Does prefix search find a word in the middle of a company name?

No. It matches the start. A word in the middle of the name is found only if the register stores another name that starts with it.

### How long must a CompanyRegistryAPI.com search be?

3 to 64 characters, according to its docs. Shorter queries get 400 invalid_request.

From [Prefix search](https://bestcompanydataapi.com/glossary/prefix-search)

## Problem details

### Which member should my code branch on?

A stable code member if the API adds one, as CompanyRegistryAPI.com does. The standard members are meant for people and for identifying the problem type.

### Did RFC 9457 replace RFC 7807?

Yes. RFC 9457 obsoletes RFC 7807 and keeps the application/problem+json media type.

From [Problem details](https://bestcompanydataapi.com/glossary/problem-details)

## Rate limit

### What unit does a rate limit count by?

It depends on the API. CompanyRegistryAPI.com counts per client address, Companies House per application and GLEIF per user, as their documentation states.

### What does an API return over its rate limit?

Usually 429 Too Many Requests, often with a Retry-After header saying how long to wait.

From [Rate limit](https://bestcompanydataapi.com/glossary/rate-limit)

## Retry-After

### Is Retry-After always in seconds?

RFC 9110 allows a number of seconds or an HTTP date. CompanyRegistryAPI.com's OpenAPI document defines it as an integer number of seconds, at least 1.

### Which CompanyRegistryAPI.com responses carry Retry-After?

Its docs name 429 rate_limited and 503 upstream_busy, and a pending register_check where supplied.

From [Retry-After](https://bestcompanydataapi.com/glossary/retry-after)

## WebMCP

### Which tools does CompanyRegistryAPI.com offer through WebMCP?

Two, according to its WebMCP page, search_companies and get_company, with the same names, inputs and answers as its MCP server.

### Where does WebMCP work today?

CompanyRegistryAPI.com's page names the ChatGPT desktop app's built-in browser, and Chrome 149+ and Edge 150+ once the site joins their origin trials.

From [WebMCP](https://bestcompanydataapi.com/glossary/webmcp)

## Library

### What does the library filter match?

Every word you type must appear in an item's title, type, topic or description. It runs in your browser and sends nothing anywhere.

### Is there a machine-readable list of pages?

Yes. llms.txt lists every page's Markdown version, and llms-full.txt has all of them in one file.

From [Library](https://bestcompanydataapi.com/library)

## Sources

### Why does the source register include the product's OpenAPI document?

Because the error guides show its synthetic problem document example verbatim. It is the product's own published contract, linked from its llms.txt and API docs.

### What if a source has changed since it was read?

The official page wins. Every record shows the day it was read; check the page again when scope, limits or terms matter to a decision.

From [Sources](https://bestcompanydataapi.com/sources)

## Entity map

### How does CompanyRegistryAPI.com relate to Coragrid?

CompanyRegistryAPI.com is a free company registry API and lookup site, powered by Coragrid, source-linked company data infrastructure. The same company operates both and publishes this site.

### Is the Coragrid API a separate company?

No. It is the keyed platform of the same operator, behind the free API, with the same permanent company IDs.

From [Entity map](https://bestcompanydataapi.com/entity-map)

## Related websites

### How do the sibling sites differ from this one?

Each answers a neighbouring question for a different reader. This one is the engineering reference for developers choosing and integrating an API.

### Do the sibling sites confirm what this site says?

No. They have the same publisher, so agreement between them is not independent corroboration. Check claims against the official sources each page cites.

From [Related websites](https://bestcompanydataapi.com/related-websites)

## Sources for this entry

This entry is editorial guidance and cites no external source.

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

- [Library](https://bestcompanydataapi.com/library) (Reference)
- [Glossary](https://bestcompanydataapi.com/glossary) (Reference)

## 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. “Questions and answers about company data APIs.” Content reviewed 17 November 2026. [https://bestcompanydataapi.com/faq](https://bestcompanydataapi.com/faq)

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