▣ DATA VALIDATION · FINANCE

VAT Company Lookup

What it does

VAT Company Lookup lets you check a business against a VAT number and get back the company details the service has on file. Send a VAT number with the two-letter country code prefix, and the response returns a data object with the company name, valid status, address, vat_number, and country_code.

Use it when you need to verify a supplier, enrich a B2B onboarding flow, or confirm that a VAT number matches an expected company before you save it to your system. The response is simple enough to plug into validation, account setup, or compliance checks without extra parsing.

Because the input is just one VAT number and the output is a single structured record, the lookup is easy to call from backend services, admin tools, and internal dashboards. If the VAT number is valid, you can use the returned company data to prefill records or flag mismatches for review.

POST

Look up company info for a VAT number

https://api.eu.apyverse.com/apyhub/look-up-company-info-for-a-vat-number

QUICKSTART

GUIDE

Quickstart

Check a VAT number by sending it in a JSON body.

curl -X POST "https://api.eu.apyverse.com/apyhub/look-up-company-info-for-a-vat-number" \
  -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. Inside data, name is the company name, valid is a boolean indicating whether the VAT number is valid, address is the company address, vat_number is the VAT number, and country_code is the country code.

{
  "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 the result in a data object. The request body must include the VAT number, including the 2-letter country code prefix.

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 details: name as a string, valid as a boolean, address as a string, vat_number as a string, and country_code as a string.

Parameter	Type	Mandatory	Description
data	Object	No	Company information returned for the VAT lookup.
data.name	String	No	Company name.
data.valid	Boolean	No	Whether the VAT number is valid.
data.address	String	No	Company address.
data.vat_number	String	No	VAT number returned by the lookup.
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.