# Ambolt Entity Resolve

> Ambolt Entity Resolve is a paid API for AI agents from api.ambolt.dev, paid per call via x402, $0.01/call, status unknown (last checked 2026-10-11).

Looks up and resolves company identities against official business registers using name, domain, registry number, LEI, or VAT number

## Facts

- Endpoint: GET https://api.ambolt.dev/v1/entity-resolve?utm_source=zero.xyz
- Price: $0.01/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-11
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/ambolt-entity-resolve-dfc786f2
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_lwj_H1mgyFT2g4gTng1fF

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability ambolt-entity-resolve-dfc786f2
```

Example prompt: Can you look up Equinor in the Norwegian business register and give me their official registry ID, LEI, legal form, and registered address?

## When to prefer this

Use this endpoint when you need to resolve a company name, domain, VAT, or registry number to an authoritative official record from government business registers. Ideal for KYC, due diligence, supplier verification, and enriching company data with LEIs and legal metadata. Prefer this over generic web search when you need structured, official register data with licensing information.

## Known failure modes

- No match found for ambiguous or misspelled company names (matched: false)
- Country not yet supported in covered registers (NO, FI, CZ, SK, FR, GB, PL only)
- Query string too long (over 200 characters)
- Rate limiting or payment failure for x402 micropayment
- Registry data may be stale or incomplete for recently incorporated companies

## How this service works

Resolve a company name, website domain, registry number, LEI or VAT number to its official legal entity: registry, registry number, legal form, status, address, industry codes, size where published and LEI. Searches national registers (Norway, Finland, Czechia, Slovakia, France, UK, Latvia, Estonia on the API and MCP; Poland by KRS number; Brazil by CNPJ, Singapore, Canadian federal corporations on the API and MCP) and GLEIF, scores the match and links every record to its…

## Output

Returns a matched flag, the best matching company record (with name, LEI, registry ID, address, legal form, industry codes, employee count, website, incorporation date, match score, match reason, source registry, and licence), a list of ranked candidate matches, and metadata including the data sources used and query timestamp.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "$schema": "https://json-schema.org/draft/2020-12/schema",
 "required": [
  "input"
 ],
 "properties": {
  "input": {
   "type": "object",
   "required": [
    "type",
    "method"
   ],
   "properties": {
    "type": {
     "const": "http"
    },
    "method": {
     "enum": [
      "GET",
      "POST"
     ]
    },
    "queryParams": {
     "type": "object",
     "properties": {
      "limit": {
       "type": "integer",
       "default": 3,
       "maximum": 10,
       "minimum": 1,
       "description": "Maximum candidates per query."
      },
      "query": {
       "type": "string",
       "maxLength": 200,
       "description": "Company name, website domain (example.com), registry number, LEI or VAT number. Use this or queries."
      },
      "country": {
       "type": "string",
       "pattern": "^[A-Za-z]{2}$",
       "description": "Optional ISO country code (NO, FI, CZ, SK, FR, GB, LV, EE, PL, BR, SG, CA) to search one register only. Faster and more precise."
      },
      "queries": {
       "type": "string",
       "description": "Up to 100 queries in one run (Apify Actor only). Each query that finds a match is one billable result."
      },
      "minScore": {
       "type": "integer",
       "default": 0,
       "maximum": 100,
       "minimum": 0,
       "description": "Only return candidates with a match score of at least this value (for example 90 for KYB checks that must not accept fuzzy matches). A query with no such candidate comes back as matched: false and is not billed."
      }
     },
     "additionalProperties": false
    }
   }
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "notes": [],
  "query": "Equinor ASA",
  "source": "Sources: official registers (Brønnøysundregistrene NLOD 2.0; PRH CC BY 4.0; ARES; INSEE/RNE Licence Ouverte 2.0; GLEIF CC0), each record names its register and licence. Informational, not a substitute for an official extract.",
  "matched": true,
  "bestMatch": {
   "lei": "OW6OFBNCKXC4US5C7523",
   "name": "EQUINOR ASA",
   "status": "active",
   "address": {
    "city": "STAVANGER",
    "street": "Forusbeen 50",
    "country": "NO",
    "postalCode": "4035"
   },
   "country": "NO",
   "licence": "NLOD 2.0",
   "website": "www.equinor.com",
   "industry": [
    {
     "code": "06.100",
     "scheme": "NACE",
     "description": "Utvinning av råolje"
    }
   ],
   "registry": "Brønnøysundregistrene (Enhetsregisteret)",
   "employees": 21272,
   "legalForm": "Allmennaksjeselskap",
   "sourceUrl": "https://data.brreg.no/enhetsregisteret/api/enheter/923609016",
   "matchScore": 100,
   "registryId": "923609016",
   "matchReason": "exact normalised name",
   "incorporationDate": "1972-09-18"
  },
  "checkedAt": "2026-10-03T11:23:47.372Z",
  "queryKind": "name",
  "candidates": [
   {
    "lei": "OW6OFBNCKXC4US5C7523",
    "name": "EQUINOR ASA",
    "status": "active",
    "address": {
     "city": "STAVANGER",
     "street": "Forusbeen 50",
     "country": "NO",
     "postalCode": "4035"
    },
    "country": "NO",
    "licence": "NLOD 2.0",
    "website": "www.equinor.com",
    "industry": [
     {
      "code": "06.100",
      "scheme": "NACE",
      "description": "Utvinning av råolje"
     }
    ],
    "registry": "Brønnøysundregistrene (Enhetsregisteret)",
    "employees": 21272,
    "legalForm": "Allmennaksjeselskap",
    "sourceUrl": "https://data.brreg.no/enhetsregisteret/api/enheter/923609016",
    "matchScore": 100,
    "registryId": "923609016",
    "matchReason": "exact normalised name",
    "incorporationDate": "1972-09-18"
   },
   {
    "name": "EQUINOR TOASTMASTERS",
    "status": "active",
    "address": {
     "city": "STAVANGER",
     "street": "Forusbeen 50",
     "country": "NO",
     "postalCode": "4035"
    },
    "country": "NO",
    "licence": "NLOD 2.0",
    "industry": [
     {
      "code": "94.992",
      "scheme": "NACE",
      "description": "Aktiviteter i andre medlemsorganisasjoner ellers"
     }
    ],
    "registry": "Brønnøysundregistrene (Enhetsregisteret)",
    "legalForm": "Forening/lag/innretning",
    "sourceUrl": "https://data.brre
… (truncated)
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/ambolt-entity-resolve-dfc786f2/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from api.ambolt.dev](https://www.zero.xyz/host/api.ambolt.dev/llms.txt)
