Jurisdiction coverage
What each capability status means, and how to read a jurisdiction page
You call the API the same way in every jurisdiction. What differs is which capabilities a jurisdiction offers, which registers the data comes from and which values those registers use. Each jurisdiction page says this for one jurisdiction, and the coverage matrix compares them side by side.
Capability statuses
Every capability on a jurisdiction page and every cell of the coverage matrix carries one status:
| Cell | What it means |
|---|---|
| Live | Callable now. |
| Credentialed | Callable once you connect your own register login as an integration. |
| Limited access | Available, switched on per organization. |
| On request | We can fulfill it, but not through a self-service API call. |
| Coming soon | Planned, not callable yet. |
| Not in register | The official register does not hold this data. |
| – | Not available through Kausate. |
A capability a jurisdiction page does not list is not available there. Live means you can call the capability, not that every company has the data.
Status is platform-wide. Whether your organization may call a capability also
depends on your entitlements:
GET /v2/platform/jurisdictions returns the
status of every capability per jurisdiction, plus an enabled flag scoped to
your API key. A Credentialed capability needs your own login with that
register, connected as an integration.
How to read a jurisdiction page
Every jurisdiction page has the same sections in the same order. A section with nothing to show for that jurisdiction says so in one line rather than disappearing, so you can read two pages side by side.
- Data sources tables, under Company report and Legal representatives and ownership, name the registers each kind of data comes from. Only available kinds are listed. Several registers mean the source depends on the company or that several records can contribute; they do not promise every field for every company. Filings describe the company at their filing or reporting date.
- Company report fields lists the fields the company report returns in that jurisdiction and the registers that supply each one; a dash means the register is not named. A listed field is filled only when the register holds it for that company.
- Legal forms, Company statuses and Roles list the values the
register uses and what the company report returns for each:
legalForm.normalized,categoryandiso20275LegalFormCode;status.normalizedandisActive; a role'senglishTranslationandnormalized. A linked column heading leads to what its values mean on Normalized values. The register's value is what the report returns asoriginal, though its case can differ. A value listed twice is used by the register for two kinds of company, such as a domestic and a foreign registration. A dash means the report returns no value there. A jurisdiction without one of these tables still returns the fields; its values are not listed.
For the records behind a particular result, read its sources and the source
references on individual values. A shareholder graph can cross jurisdictions;
each company in it comes from the registers its own jurisdiction page names.
Registered beneficial owners and ownership derived from shareholders are
different evidence, so read them separately.
Related
- Company search: find a company and its
kausateIdbefore you order anything. - Sync and async: the two ways to call every capability.
- Documents: ordering documents by shortcut, document code or document ID.
- Integrations: connect your own register login.
- Errors: the same error body and codes in every jurisdiction.
Last updated on