▣ DATA VALIDATION · FINANCE

VAT Company Lookup API

Hosted on ApyHub

What it does

VAT Company Lookup lets you verify a VAT number and retrieve the company details associated with it. Send a single vat value in the request body, and get back the validation result plus the matching company record when it is available.

Use it when you need to confirm customer or supplier tax IDs during onboarding, invoicing, or checkout. The response includes valid along with the company name, address, vat_number, and country_code inside data, so you can decide whether to trust the identifier and display the registered business details.

It is a good fit for compliance checks, B2B account creation, and reducing manual review of VAT entries. If the number is invalid or cannot be resolved, the API still gives you a structured response you can handle programmatically.

Keep the input to the full VAT number, including the two-letter country prefix.

POST

Look up company info for a VAT number

http://localhost:8080/apyhub/lookup-vat-company

QUICKSTARTGUIDE

Quickstart

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

curl -X POST "http://localhost:8080/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

API key

Loading your default key…

The full key is used to call the gateway and stays in this tab — never sent to orbit or saved.

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

Parameter	Type	Mandatory	Description
vat	String	Yes	VAT 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.

Parameter	Type	Mandatory	Description
data	Object	No	Company information object.
data.name	String	No	Company name.
data.valid	Boolean	No	Whether the VAT lookup is valid.
data.address	String	No	Company address.
data.vat_number	String	No	VAT number.
data.country_code	String	No	Country code associated with the VAT number.

Body

Name

Type

Description

bodyREQUIRED

object

—

▣ 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.