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

# GlobalEntity API

The GlobalEntity API resolves a company name and country, or a registration number, to a single normalized company record drawn from European business registers and the global GLEIF LEI index. It searches registers, verifies VAT, EORI, and LEI identifiers, deduplicates company-name lists, and returns ownership graphs with ultimate beneficial owner candidates. Insolvency checks, bank and IBAN verification, exportable KYB reports, and webhook-driven entity monitoring round out the surface.

## For AI agents

Resolve and normalize official company data across European registers and GLEIF, verify VAT, EORI, and LEI, deduplicate names, and monitor entity changes.

## Scope

Does not run payments, score credit, or file documents with registers. Use for looking up and resolving official company data and monitoring entity changes only.

## Capabilities

- Resolve a company name and country to a single normalized golden record
- Search a company register and fetch a stored golden record by id
- Verify a VAT, EORI, or LEI identifier
- Deduplicate a list of company names against canonical records
- Retrieve an ownership graph with ultimate beneficial owner candidates
- Check insolvency state and subscribe to entity-change monitoring with webhooks

## Use cases

### Agent-Driven KYB Resolution

An AI agent onboards a business customer and needs one trustworthy company record before it proceeds. It resolves the company name and country to a golden record, verifies the VAT and LEI, and pulls the ownership graph to flag ultimate beneficial owners. Jentic exposes each GlobalEntity operation with its input schema so the agent sends the name, country, or identifier correctly on the first call.

Example prompt: Resolve a company by name and country to a golden record, verify its VAT and LEI, then retrieve its ownership graph

### VAT and Identifier Verification

A billing system must confirm a counterparty's tax and legal identifiers before invoicing cross-border. The GlobalEntity API verifies VAT, EORI, and LEI values and can verify a bank account or IBAN, returning a normalized result regardless of the source register. The system records the verification against its own customer record.

Example prompt: Verify a company's VAT and EORI identifiers, then verify its IBAN before invoicing

### Entity Monitoring

A compliance team watches a portfolio of companies for status changes rather than re-checking by hand. The GlobalEntity API creates monitoring subscriptions, lists them, updates or pauses them, and sends a test ping to a subscription's webhook so the team confirms delivery. Insolvency state can be checked on demand alongside the monitoring feed.

Example prompt: Create a monitoring subscription for a company with a webhook, then send a test ping to confirm the webhook receives events

## Key endpoints

| Method | Path | Description |
| --- | --- | --- |
| POST | `/api/company/resolve` | Resolve a company to a golden record |
| GET | `/api/registry/search` | Search a company register |
| GET | `/api/verify` | Verify VAT, EORI, or LEI |
| POST | `/api/company/match` | Deduplicate a list of company names |
| GET | `/api/company/ownership` | Retrieve an ownership graph with UBO candidates |
| GET | `/api/company/insolvency` | Check bankruptcy and insolvency state |
| POST | `/api/monitor/subscriptions` | Create an entity-monitoring subscription |

## Key resources

- **Registry search** — Search a company register by name and country
- **Company** — Resolve to a golden record, deduplicate names, and fetch ownership, report, insolvency, IBAN, and stored records
- **Verify** — Verify VAT, EORI, and LEI identifiers
- **Monitor** — Create, list, update, and delete entity-monitoring subscriptions and send test webhook pings

## 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:** 65 / 100
- **Maturity:** AI-Aware
- **Dimensions:**
  - Foundational Compliance: 76 / 100
  - Developer Experience & Jentic Compatibility: 69 / 100
  - AI-Readiness & Agent Experience: 49 / 100
  - Agent Usability: 94 / 100
  - Security: 50 / 100
  - AI Discoverability: 81 / 100
- **View full report:** https://jentic.com/apis/globalentityapi.com/globalentityapi/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 the GlobalEntity API by hand means managing its x-api-key header and learning the resolve, verify, ownership, and monitoring operations that unify dozens of per-country registers. Through Jentic you install once, import GlobalEntity from the API Directory, store the key once, and your agent calls it.
- **Permission scoping:** GlobalEntity's lookups take the company name, country, or identifier in the request body or query, so a rule bounds which operations your agent may call, such as resolve and verify, not which company. You choose the operations it may call, so creating or deleting a monitoring subscription is not included unless you add them.
- **Credential handling:** Your GlobalEntity 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 'resolve a company' or 'verify a VAT number', and Jentic returns the matching GlobalEntity operation with its input schema so the agent calls the right endpoint without reading the reference docs.

## Related APIs

- **Clearbit** — Clearbit returns firmographic company and contact enrichment, weighted to US data.
- **UK Companies House** — Companies House is the official UK register GlobalEntity normalizes alongside others.
- **Truora** — Truora runs background and identity checks.

## FAQ

### What authentication does the GlobalEntity API use?

The GlobalEntity API authenticates with an API key sent in the x-api-key header on every request per its OpenAPI spec. Through Jentic that key is stored encrypted by your own Jentic One instance and injected at call time, so it never sits in your agent's prompt or logs.

### Can I resolve a company with the GlobalEntity API?

Yes. You send a company name and country, or a registration number, to the resolve operation and get back a single normalized golden record with legal name, registration number, address, legal form, status, VAT, and LEI. The data comes back the same shape regardless of which European register it was drawn from.

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

The GlobalEntity OpenAPI spec does not publish fixed rate limits. Responses are cached for speed, so repeated lookups of the same entity are inexpensive; pace fresh resolutions and back off on errors rather than assume an unlimited quota.

### Is there a GlobalEntity MCP server?

You do not need an MCP server to give your agent the GlobalEntity API. Jentic connects it directly from the API Directory: import it, store your API key once, and your agent calls its operations. Operations are discovered on demand, so your agent's context stays lean instead of loading a full tool list up front.

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

Yes. Write a rule that allows only the search, resolve, and verify read operations, so the agent can look up and verify companies but cannot create or delete monitoring subscriptions, and every call it makes is logged. Subscription writes stay out of the allowed set until you add them.

### How do I resolve a company with the GlobalEntity API through Jentic?

Search Jentic for 'resolve a company to a golden record', and it returns the GlobalEntity resolve operation with its input schema. Your agent sends the name and country and reads the normalized record back. To run it on your own infrastructure, install Jentic One from its GitHub repo.