VATFIND REST API

VAT lookup and company data API.
Connect the number to the company.

Find a company’s VAT number, match a supplied VAT ID or US EIN, and return legal-company details to your application. Build supplier onboarding, invoice checks and company-data enrichment with structured JSON responses.

COMPANY SEARCH, VAT LOOKUP & EIN MATCHING

Start with the information you already have.

A company data API lets software search for a business and retrieve its attributes. VATFind focuses on legal-company identity and business identifiers: a company name can lead to an available VAT number, while a supplied VAT number or EIN can lead back to a company record.

Choose the VATFind API request that matches your input
Your inputRequestUse the result to
Company name + countryPOST /v1/companies/search with name and country_codeCompare candidate companies and retrieve an available VAT number or EIN.
VAT number + countryPOST /v1/checks with identifier_type: vat_numberCompare the linked company name, address and status with your supplier record.
US EINPOST /v1/checks with identifier_type: tax_identifier and country_code: USReview the available EIN-to-company association for a US vendor.
Company registration numberPOST /v1/companies/search with registration_number and country_codeResolve the legal entity when the VAT number is missing from your system.
SUPPLIER ONBOARDING

Match the legal counterparty

Compare submitted names and tax IDs before creating the vendor record. Send ambiguous matches to review with the returned evidence.

Supplier VAT and EIN checks →
ACCOUNTS PAYABLE

Check invoice details

Use the VAT lookup API to compare the invoice issuer with the company associated with its tax identifier.

Invoice verification workflow →
DATA ENRICHMENT

Complete company records

Enrich ERP, CRM and finance records with available registration numbers, legal names, addresses and tax IDs.

Company data enrichment →

RESPONSE DATA DICTIONARY

Which company data fields does the API return?

These are the fields in VATFind’s public Company schema. Search results return company objects in data[]; a matched identifier check can include one in company. Required properties describe the response shape, not a guarantee that every identifier array contains a value.

Required properties of a returned Company object
FieldTypeMeaning
idstringWorkspace-scoped company ID for retrieval in the same environment.
objectcompanyIdentifies the response object as a company.
legal_namestringLegal company name returned by the record.
country_codestringTwo-letter country code used to interpret identifiers.
vat_numbersstring[]Available VAT numbers; the array can be empty.
tax_identifiersstring[]Available business tax IDs, including a US EIN where supplied.
company_legal_statusenumCompany state such as active, dissolved or unknown.
sourcesobject[]Source type, with source name and URL where supplied.
retrieved_atdate-timeWhen VATFind retrieved the company record.

Additional attributes where available

Optional Company properties depend on country and source coverage
FieldTypeMeaning
registration_numberstringCompany registration identifier.
raw_company_legal_statusstringOriginal company-status wording.
legal_formstringReturned legal form.
incorporation_datedateCompany incorporation date.
registered_address.formattedstringRegistered address as formatted text.
websiteURICompany website where returned.

Identifier checks also return format_status, registry_match_status, tax_authority_status, company_legal_status, evidence, warnings and credits_used. Keep these alongside the check ID so your team can explain a result later.

YOUR FIRST API REQUEST

Test the response before adding live records.

Create a vf_test_… key in the developer dashboard and run the sample request. Test keys return deterministic GB, DE and US fixtures. Use the returned statuses to implement matching, review and retry paths.

The REST base URL is https://vatfind.com/v1. Authentication uses Authorization: Bearer; JSON requests use Content-Type: application/json. Keep the key on your server.

Use a fresh idempotency key for each new billable operation and keep that same key when retrying it. Once your integration is ready, use a vf_live_… key with active paid access and available workspace credits.

const response = await fetch("https://vatfind.com/v1/checks", {
  method: "POST",
  headers: {
    "Authorization": `Bearer ${process.env.VATFIND_API_KEY}`,
    "Content-Type": "application/json",
    "Idempotency-Key": crypto.randomUUID()
  },
  body: JSON.stringify({
    identifier_type: "vat_number",
    identifier: "GB123456789",
    country_code: "GB"
  })
});

const check = await response.json();
if (!response.ok) throw new Error(check.detail);
console.log(check.registry_match_status);
Sandbox API · deterministic sample data

Search, check and monitor through one REST interface

Selected endpoints; the API documentation lists the complete contract
MethodEndpointPurpose
POST/v1/checksCheck a VAT number, US EIN or company registration number.
GET/v1/checks/{check_id}Retrieve a completed check and its evidence.
POST/v1/companies/searchFind companies by name or supported business identifier.
GET/v1/companies/{company_id}Retrieve a company snapshot from your workspace.
GET/v1/countries/{country_code}Read country-specific formats and capabilities.
POST/v1/monitorsCreate a company baseline and monitoring schedule.
GET/v1/monitoring-eventsRead company changes and monitoring health events.
GET/v1/usageCheck current-period usage and remaining allowance.

IMPLEMENTATION READINESS

Plan the decisions around the API call.

Use this browser-only checklist to expose integration gaps before switching from deterministic sandbox fixtures to live records. Selections are not sent or saved.

0 of 4 controls coveredNext control: Target countries checked.

CHOOSING A VAT API

VAT number lookup and VAT validation answer different questions.

VAT lookup identifies the company associated with a number, or finds an available number from a company name. Live VAT validation asks a tax authority whether a registration is valid at the time of the request. Choose the service by the evidence your application needs.

Company matching compared with official VAT-registration checks
RequirementAppropriate routeEvidence to retain
Find a VAT number by company nameVATFind company search APISelected company, returned identifiers, source context and retrieval time.
Match a VAT number or US EIN to a companyVATFind identifier checksMatch state, legal-company details, warnings and check ID.
Check EU VAT registration through VIESOfficial VIES service or an integration providing a live VIES responseThe authority response and time of the check.
Check current UK VAT registrationHMRC Check a UK VAT Number serviceThe returned business details and consultation reference where provided.
Current VATFind authority capability

VATFind’s current REST checks use company-record evidence and do not call live VIES, HMRC or IRS services. Read tax_authority_status explicitly. A matched company or valid number format does not establish an active tax registration or an IRS TIN match.

COVERAGE, VOLUME & PRICING

Evaluate the API against your company records.

Check your target countries and identifier formats before estimating volume. Use the country endpoint to inspect capabilities, then compare a representative sample of your supplier or customer records. Coverage varies by country, identifier and field.

Live REST and MCP share your workspace credit balance. Review current check allowances and prices on the pricing page; bulk company datasets are scoped separately.

Planning high-volume checks?

Process individual API requests with the documented rate limits, idempotency and retry rules. For an initial company dataset or recurring file delivery, discuss a bulk feed. The REST contract does not expose a single bulk-validation endpoint.

API fields and capabilities reviewed 11 October 2026.

VAT & COMPANY API QUESTIONS

Evaluate the API before you integrate.

Company search, VAT and EIN matching, exact response fields, sandbox access and production use.

What is a company data API?

A company data API lets applications search for businesses and retrieve their attributes. VATFind focuses on legal-company identity, VAT numbers, US EINs, registration details and company-record monitoring for onboarding, invoice checks and data enrichment.

Can I find a VAT number by company name through the API?

Yes. Send the company name and country_code to POST /v1/companies/search. Review the returned company candidates and their vat_numbers. Results depend on coverage; an empty array means no VAT number was returned for that record.

Can the API look up or verify a US EIN?

VATFind can search US company records and check an EIN-to-company association. Use country_code US and identifier_type tax_identifier for an identifier check. This is company-record matching, not an IRS TIN Matching response or confirmation of federal tax status.

Which company data attributes are available?

The Company schema contains id, object, legal_name, country_code, vat_numbers, tax_identifiers, company_legal_status, sources and retrieved_at. Optional properties include registration_number, raw_company_legal_status, legal_form, incorporation_date, registered_address and website. Availability varies by record.

Is VATFind a live VIES or HMRC VAT validation API?

No. Current VATFind REST checks use company-record evidence and do not query live VIES, HMRC or IRS services. Read tax_authority_status separately. A valid format or matched company does not establish an active VAT registration.

How do I get a VATFind API key?

Sign in to the developer dashboard and create an API key. Use a vf_test_ key for deterministic GB, DE and US fixtures. Use a vf_live_ key with active paid access and available credits for live processing. Keep the key in server-side secret storage.

START INTEGRATING

Get your API key and inspect the first response.

Use sandbox fixtures to build your workflow, then connect live company data through the same REST interface.

Get your API key