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 →VATFIND REST API
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
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.
| Your input | Request | Use the result to |
|---|---|---|
| Company name + country | POST /v1/companies/search with name and country_code | Compare candidate companies and retrieve an available VAT number or EIN. |
| VAT number + country | POST /v1/checks with identifier_type: vat_number | Compare the linked company name, address and status with your supplier record. |
| US EIN | POST /v1/checks with identifier_type: tax_identifier and country_code: US | Review the available EIN-to-company association for a US vendor. |
| Company registration number | POST /v1/companies/search with registration_number and country_code | Resolve the legal entity when the VAT number is missing from your system. |
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 →Use the VAT lookup API to compare the invoice issuer with the company associated with its tax identifier.
Invoice verification workflow →Enrich ERP, CRM and finance records with available registration numbers, legal names, addresses and tax IDs.
Company data enrichment →RESPONSE DATA DICTIONARY
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.
| Field | Type | Meaning |
|---|---|---|
id | string | Workspace-scoped company ID for retrieval in the same environment. |
object | company | Identifies the response object as a company. |
legal_name | string | Legal company name returned by the record. |
country_code | string | Two-letter country code used to interpret identifiers. |
vat_numbers | string[] | Available VAT numbers; the array can be empty. |
tax_identifiers | string[] | Available business tax IDs, including a US EIN where supplied. |
company_legal_status | enum | Company state such as active, dissolved or unknown. |
sources | object[] | Source type, with source name and URL where supplied. |
retrieved_at | date-time | When VATFind retrieved the company record. |
| Field | Type | Meaning |
|---|---|---|
registration_number | string | Company registration identifier. |
raw_company_legal_status | string | Original company-status wording. |
legal_form | string | Returned legal form. |
incorporation_date | date | Company incorporation date. |
registered_address.formatted | string | Registered address as formatted text. |
website | URI | Company 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
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);{
"identifier_type": "vat_number",
"identifier": "GB123456789",
"country_code": "GB",
"client_reference": "invoice-1048"
}| Method | Endpoint | Purpose |
|---|---|---|
| POST | /v1/checks | Check a VAT number, US EIN or company registration number. |
| GET | /v1/checks/{check_id} | Retrieve a completed check and its evidence. |
| POST | /v1/companies/search | Find 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/monitors | Create a company baseline and monitoring schedule. |
| GET | /v1/monitoring-events | Read company changes and monitoring health events. |
| GET | /v1/usage | Check current-period usage and remaining allowance. |
IMPLEMENTATION READINESS
Use this browser-only checklist to expose integration gaps before switching from deterministic sandbox fixtures to live records. Selections are not sent or saved.
CHOOSING A VAT API
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.
| Requirement | Appropriate route | Evidence to retain |
|---|---|---|
| Find a VAT number by company name | VATFind company search API | Selected company, returned identifiers, source context and retrieval time. |
| Match a VAT number or US EIN to a company | VATFind identifier checks | Match state, legal-company details, warnings and check ID. |
| Check EU VAT registration through VIES | Official VIES service or an integration providing a live VIES response | The authority response and time of the check. |
| Check current UK VAT registration | HMRC Check a UK VAT Number service | The returned business details and consultation reference where provided. |
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
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.
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.
VAT & COMPANY API QUESTIONS
Company search, VAT and EIN matching, exact response fields, sandbox access and production use.
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.
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.
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.
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.
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.
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
Use sandbox fixtures to build your workflow, then connect live company data through the same REST interface.