vatfind
Try it free

BROWSER CONTRACT · CURRENT BETA

Company lookup,
documented.

A reference for the endpoints used by this VATFind website.

These routes require the site’s access policy and same-origin browser requests. They are not a public server-to-server API. Customer API keys have not been enabled.

Search request

Submit a company name or tax identifier with a supported country. Use the website search tool to make a live request.

POST/api/lookup
FieldTypeDescription
modestringname or vat. Required.
querystringA legal name (2–150 characters) or tax ID. US EINs must normalize to 9 digits.
countrystringA supported two-letter code, such as GB or US.
regionstringOptional state or province for the United States or Canada.
const response = await fetch("/api/lookup", {
  method: "POST",
  headers: { "Content-Type": "application/json" },
  body: JSON.stringify({
    mode: "name",
    query: "Global Data Intelligence",
    country: "GB"
  })
});

const result = await response.json();
if (!response.ok) throw new Error(result.error);
console.log(result.companies);
Browser endpoint · same-origin requests only

Company response

A completed search returns companies and the network’s remaining free allowance. Results are limited to the first 20 unique matching records returned after normalization and country filtering.

Identity
id, name, registrationNumber, countryCode
Tax ID
vatNumber may be null. Its presence does not establish active registration.
Source
source includes the available source name and safe URL. retrievedAt is the retrieval timestamp.
Detail access
detailToken authorizes opening that result’s details. Treat it as a temporary capability, not an account API key.

Company details

POST/api/lookup/details

The browser sends { "token": "<detailToken from search>" }. Tokens expire after 30 minutes and are tied to the originating daily network allowance.

Available detail fields include address, legal form, incorporation date and company registry status. Details may be cached for 15 minutes, retaining their original retrieval timestamp. Opening details does not consume an additional free search.

There is no vatValid field. Company status must never be used as a substitute for tax-authority validation.

Limits & errors

Three completed searches are available per network per UTC day. Empty results count. Upstream failures refund the reserved search. Additional abuse and global capacity limits can temporarily restrict requests.

StatusMeaningNext step
400Input or token problemCheck the fields or run a new search.
403Origin rejected or detail token invalidUse this website and a fresh result.
415Content type not supportedSend application/json.
422Source could not search this combinationReview the country, name, or tax ID.
429Daily or service rate limitRead the error; wait for the indicated reset.
502 / 503Source or service unavailableTry again later; do not infer an invalid tax ID.

Public API status

Customer API keys, paid credits, external access, and a stable versioned API are not live yet. Do not build a production integration against these browser-only routes. This reference will be updated when the public contract is released.

Back to the API overview