canonical: https://jentic.com/apis/jsonpage.com/jsonpage

# Jsonpage API

The Jsonpage API returns official company register data for 14 countries, including France, Belgium, Switzerland, the United Kingdom, the Nordic and Baltic states, Ireland, Australia, Singapore, and Japan, in one record format keyed by a global identifier such as FR-552032534. A lookup can add optional blocks such as address, establishments, VAT, EORI, officers, financials, owners, sanctions, and legal events, and a batch call resolves up to 100 companies at once. For forms it suggests companies as a user types and checks a company identifier, SIRET, VAT number, and EORI number in one call. Monitoring compares watched companies against the registers, legal notices, beneficial ownership data, and sanctions lists, records each change as an event, and can deliver events as signed webhooks.

## For AI agents

Look up and verify companies in 14 countries from official registers: search by name or registry number, pull officers, owners, financials, and sanctions blocks, validate VAT, SIRET, and EORI numbers, and monitor companies for changes.

## Scope

Does not handle credit scoring, contact enrichment, or company filings documents. Use for company register lookups, identifier validation, and change monitoring only.

## Capabilities

- Search companies by name across every served country or find one by registry_id, with active-only filtering
- Look up a company by global identifier and add optional include blocks such as officers, owners, financials, sanctions, and legal_events
- Resolve up to 100 company identifiers in one batch call, with per-item errors for invalid or unknown ids
- Check a company identifier, SIRET, VAT number, and EORI number together and get a single valid result
- Suggest matching companies while a user types into a form with the autocomplete endpoint
- Start or stop monitoring a company and read the change events detected against registers and sanctions lists
- List a company's establishments with cursor paging

## Use cases

### Agent Supplier Verification via Jentic

An AI agent processing supplier onboarding calls the Jsonpage validate operation with the company identifier and VAT number from the form, and reads back a single valid flag with each check's result and the matching company record. Through Jentic the agent finds the operation by intent and calls it with your stored key, then fetches the sanctions and owners blocks before approving the supplier.

Example prompt: Validate company id 'BE-0417497106' together with its VAT number, then look up the company with include=sanctions,owners and report whether it is safe to onboard

### Form Autocomplete for Company Fields

Signup and checkout forms call the autocomplete endpoint with the text a user has typed, optionally limited to active companies, and fill in the company name, identifier, and address from the chosen suggestion. Name search ignores case, accents, punctuation, and legal forms such as SA or LTD, so 'dano' finds DANONE.

Example prompt: Call autocomplete with q 'dano' and status 'active', pick the top suggestion, and return its identifier and registered address

### Customer Portfolio Monitoring

Credit and compliance teams add each customer to the monitoring list with a PUT on its identifier, which records today's state as the baseline. Later differences against registers, legal notices, beneficial ownership information, and sanctions lists appear as events, which are read with an after cursor or delivered by signed webhook, and are kept 90 days.

Example prompt: Start monitoring companies 'FR-552032534' and 'GB-00445790', then list events after the last processed event id and summarise any ownership or status changes

### Customs Number Checks for Shipping

Logistics teams check an EORI number by calling the EORI endpoint with the number and, optionally, the expected company_name before booking a cross-border shipment. The same check can run inside the validate call alongside the VAT number.

Example prompt: Check the EORI number from a shipping form with company_name 'Danone' and report whether it is valid and matches that company

## Key endpoints

| Method | Path | Description |
| --- | --- | --- |
| GET | `/companies` | Search companies by name or registry number |
| GET | `/companies/{id}` | Look up a company by global identifier |
| POST | `/companies/batch` | Look up up to 100 companies |
| GET | `/validate` | Check identifier, SIRET, VAT, and EORI |
| GET | `/autocomplete` | Suggest companies as the user types |
| PUT | `/monitors/{id}` | Start monitoring a company |
| GET | `/events` | List detected events |

## Key resources

- **Companies** — Base company records by global identifier with optional blocks for officers, owners, financials, sanctions, and more.
- **Establishments** — The sites and branches of a company.
- **Validation** — Combined identifier, SIRET, VAT, and EORI checks.
- **Monitors and events** — Watched companies and the changes detected for them.

## AI readiness

This API is usable in Jentic One now. Its AI-readiness score against Jentic's framework shows where it stands today and where improvements would make it even easier for agents to use.

- **Score:** 66 / 100
- **Maturity:** AI-Aware
- **Dimensions:**
  - Foundational Compliance: 74 / 100
  - Developer Experience & Jentic Compatibility: 72 / 100
  - AI-Readiness & Agent Experience: 51 / 100
  - Agent Usability: 94 / 100
  - Security: 50 / 100
  - AI Discoverability: 81 / 100
- **View full report:** https://jentic.com/apis/jsonpage.com/jsonpage/scorecard
- **How the score is calculated:** https://docs.jentic.com/reference/api-readiness-framework/overview/
- **More about the dimensions:** https://docs.jentic.com/reference/api-readiness-framework/specification/#dimensional-model-overview

### Score it yourself

Every API in the directory is allowlisted, so you can re-score it with no key required.

- **Score your own API:** https://jentic.com/scorecard.md
- **Scoring CLI agent skill:** https://github.com/jentic/jentic-api-scorecard/blob/main/skills/jentic-api-scorecard/SKILL.md

```sh
npx @jentic/api-scorecard-cli score <openapi-url>
```

## Why Jentic

- **Setup:** Wiring Jsonpage by hand means sending its `X-API-Key` header, learning each country's identifier format and check digits, and handling the plan rate limit where each company in a batch counts as one request. Through Jentic you install once, import Jsonpage from the API Directory, store the key once, and your agent calls it.
- **Permission scoping:** Jsonpage puts the company identifier in the URL path (`/companies/{id}`, `/monitors/{id}`), so a rule can pin your agent to the companies and operations you pick. You choose the operations it may call, so changes like adding or removing monitors are not included unless you add them.
- **Credential handling:** Your Jsonpage API key is stored once, encrypted, by your own Jentic One instance and injected at execution time. It never enters the agent's prompt, logs, or context.
- **Discovery method:** Agents search Jentic by intent such as 'verify a VAT number' or 'look up a company by registry number', and Jentic returns the matching Jsonpage operation with its input schema so the agent calls the right endpoint without browsing the reference docs.

## Related APIs

- **OpenCorporates API** — OpenCorporates covers a wider set of jurisdictions; Jsonpage adds VAT, EORI, and SIRET validation and change monitoring.
- **Pappers API** — Pappers focuses on French company data; Jsonpage serves France and 13 other countries in one format.
- **UK Companies House** — Companies House is the UK register itself; Jsonpage normalises UK records alongside other countries.
- **GLEIF LEI API** — GLEIF returns Legal Entity Identifiers and parent relationships that complement register data.

## FAQ

### What authentication does the Jsonpage API use?

The Jsonpage API authenticates with an API key sent in the `X-API-Key` header, per its OpenAPI spec. Keys are created in the Jsonpage dashboard, a rotated key keeps working for 24 hours, and on the Pro plan keys can be restricted to allowed IP addresses. The three health endpoints are open and need no key. Through Jentic the key is stored encrypted by your own Jentic One instance and injected at call time.

### Is there a Jsonpage MCP server?

You don't need an MCP server to give your agent Jsonpage. Jentic connects it directly from the API Directory: import it, store your key once, and your agent searches, verifies, and monitors companies as it needs to. Operations are discovered on demand, so no extra server's tool definitions sit in your agent's context.

### Can I limit what my agent is allowed to do with the Jsonpage API?

Yes. For example, write a rule that allows only the validate, autocomplete, and company lookup operations, so an onboarding agent can check and read companies but cannot add or remove monitors. Because the company identifier sits in the path, a rule on `/companies/{id}` can also hold an agent to one company, and every call it makes is logged.

### Which countries does the Jsonpage API cover?

Per its OpenAPI spec, the Jsonpage API serves company data for 14 countries: France, Belgium, Switzerland, the United Kingdom, Norway, Finland, Latvia, Ireland, Sweden, Estonia, Lithuania, Australia, Singapore, and Japan. Identifiers take the country code, a hyphen, and the national registry number, for example GB-00445790 or JP-1180301018771.

### What are the rate limits for the Jsonpage API?

The Jsonpage OpenAPI spec says requests count against a plan rate limit, with each company in a batch call counting as one request, and a free plan has a daily cap; exceeding either returns a rate_limit_exceeded or daily_limit_reached error with a Retry-After delay. The spec does not publish the numbers, so check https://jsonpage.com for your plan's limits.

### How do I verify a VAT number with the Jsonpage API through Jentic?

Search Jentic for an intent like 'verify a company VAT number', import Jsonpage from the API Directory, and store your API key once. Your agent then calls GET /validate with the vat parameter, adding id or siret to check them together, and reads the valid flag and the matching company record. To run it on your own infrastructure, install Jentic One from its GitHub repo.