apyhub
Back
▣ DATA VALIDATION · FINANCE

VAT Company Lookup API

Hosted on ApyHub

What it does

The VAT Lookup API turns a VAT number into a company. Send the number with its country prefix, get back the registered name, the registered address, the country code, and whether the number is valid.

This is what an invoice needs. In most EU countries a compliant B2B invoice has to carry the customer's registered legal name and address, not the trading name they typed into your signup form. Pull them from the number and the invoice is right the first time.

It also catches the mismatch worth catching. When the returned company name looks nothing like the account name in front of you, someone has entered a VAT number that is not theirs. That is worth a flag in onboarding, before the reverse charge gets applied to the wrong entity.

Three places it fits: B2B signup, supplier onboarding, and invoice generation. Prefill the fields, keep the record, move on.

Only need a yes or no? The Validate EU VAT API is the cheaper call. Checking a list? The Validate EU VAT Batch API takes up to 10 at a time. Need beneficial owners and filings as well? The Company KYB Lookup API goes deeper.

POST
Look up company info for a VAT number
https://api.eu.apyhub.com/apyhub/lookup-vat-company

QUICKSTART

GUIDE

Quickstart

Look up a company by VAT number using a simple JSON request.

curl -X POST "https://api.eu.apyhub.com/apyhub/lookup-vat-company" \
  -H "apy-token: $APY_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"vat":"NL862735944B01"}'

What you'll get back

Returns a JSON object with a data object. The data object can include name (string), valid (boolean), address (string), vat_number (string), and country_code (string).

{
  "data": {
    "name": "ACME GmbH",
    "valid": true,
    "address": "Musterstraße 1, 10115 Berlin",
    "vat_number": "345789108",
    "country_code": "DE"
  }
}
TRY ITLIVE · 50 ATOMS
Loading your default key…
The full key is used to call the gateway and stays in this tab — never sent to orbit or saved.
body*
VAT number including 2-letter country code prefix.

About this endpoint

What it does

Looks up company information for a VAT number and returns a JSON object containing the result under data. The request sends a VAT number in the body, and the response includes the company details exposed by the output schema.

Request Body

ParameterTypeMandatoryDescription
vatStringYesVAT number including 2-letter country code prefix.

Response

Returns a JSON object with a data object field. The data object contains company information fields such as name, valid, address, vat_number, and country_code.

ParameterTypeMandatoryDescription
dataObjectNoCompany information object.
data.nameStringNoCompany name.
data.validBooleanNoWhether the VAT lookup is valid.
data.addressStringNoCompany address.
data.vat_numberStringNoVAT number.
data.country_codeStringNoCountry code associated with the VAT number.
▣ COMMON ERRORS

Errors any endpoint can return

400bad_request

Required parameter missing or malformed body.

401unauthorized

API key missing, revoked, or not authorized for this service.

429rate_limited

Your plan's per-second rate exceeded. Retry with exponential backoff.

503upstream_busy

Backend temporarily unavailable. Try again in a few seconds.