vatnode

Portugal VAT API — Validate Portugal VAT Numbers in Real Time

REST JSON endpoint for verifying Imposto sobre o Valor Acrescentado (IVA) numbers against the official EU VIES register, with national registry fallback where available and a VIES consultation number once you set your own VAT as requester in dashboard Settings.

Get a free API key Portugal VAT number format

Why a Portugal-Aware VAT API

In Portugal, VAT is known as Imposto sobre o Valor Acrescentado (IVA) and the current standard rate is 23%. Every Portugal VAT number starts with the prefix PT and follows a fixed structure issued by the Portuguese tax authority. A generic VAT validator that ignores country-specific quirks will accept malformed input, miss the country's format rules, and fail to surface the local registry identifier that accountants and auditors actually need.

The vatnode API normalises IVA input, runs the official VIES check, and returns a single JSON shape with the consultation number, company data where published, and the current Portugal VAT rates inline.

Portugal VAT Number Format

Structure
PT + 9 digits
Regex pattern
^PT\d{9}$

Real Portugal VAT numbers you can validate right now:

Validating Portugal VAT Numbers — Code Examples

All three examples validate the same Portugal VAT number PT500100144. To receive a consultation number back, set your own VAT as requester once in dashboard Settings — then every call, including these, returns a consultation number automatically, with no extra parameters.

curl
curl 'https://api.vatnode.dev/v1/vat/PT500100144' \
  -H "Authorization: Bearer YOUR_API_KEY"
Node.js (fetch)
const res = await fetch(
  'https://api.vatnode.dev/v1/vat/PT500100144',
  { headers: { Authorization: `Bearer ${process.env.VATNODE_API_KEY}` } }
)
const data = await res.json()
console.log(data.valid, data.companyName, data.consultationNumber)
Python (httpx)
import os, httpx

r = httpx.get(
    "https://api.vatnode.dev/v1/vat/PT500100144",
    headers={"Authorization": f"Bearer {os.environ['VATNODE_API_KEY']}"},
)
data = r.json()
print(data["valid"], data["companyName"], data["consultationNumber"])

What You Get Back

A successful response for a valid PortugalVAT number, once you've set your VAT as requester in dashboard Settings, looks like this:

{
  "valid": true,
  "vatId": "PT500100144",
  "countryCode": "PT",
  "countryName": "Portugal",
  "companyName": "Jerónimo Martins SGPS SA",
  "consultationNumber": "WAPIAAAAXk7ZpY3o",
  "source": "VIES",
  "countryVat": {
    "currency": "EUR",
    "standardRate": 23,
    "reducedRates": [6,13,16,22],
    "superReducedRate": 6,
    "parkingRate": 13
  },
  "verifiedAt": "2026-05-19T08:14:22Z"
}

When the number is not registered, valid is false and company fields are null. The consultationNumber is the EU VIES requestIdentifier — the documented audit reference for reverse-charge "reasonable care" evidence. It is returned once you set your own VAT as requester in dashboard Settings; otherwise it is null.

Portugal VAT Rates

vatnode returns the current Portuguese IVA rates inline with every successful response. Today's rates (standard 23%, reduced 6%, 13%, 16%, 22%, super-reduced 6%, parking 13%) are sourced from the European Commission TEDB feed, checked daily and updated on any change.

Rate typeValue
Standard23%
Reduced (1)6%
Reduced (2)13%
Reduced (3)16%
Reduced (4)22%
Super-reduced6%
Parking13%

VIES vs National Fallback for Portugal

For Portugal, VIES is the sole authoritative source. vatnode does not run a national-registry fallback for this country today — when VIES is unavailable, the API surfaces a structured VIES_UNAVAILABLE error with retry guidance so you can degrade gracefully rather than silently accept unverified numbers.

Cached VIES responses (15-minute TTL on identical VAT IDs) absorb the majority of short outages transparently. For the full per-country fallback status, see the coverage matrix.

Portugal VAT API — FAQ

Is the Portugal VAT number the same as the company registration number?

No. The Portuguese IVA number is issued for VAT purposes and is distinct from any local company registration number. vatnode returns the IVA number plus, when available, the registry identifier filed with the national company registry.

How fast is Portugal VAT validation through vatnode?

Cached responses return in single-digit milliseconds. Live VIES lookups for Portugal typically complete in under one second; a 15-minute Redis cache is applied to identical VAT IDs.

Does the API work for Portuguese sole traders and small businesses?

Yes. If a Portuguese sole trader or small business is registered for IVA and listed in VIES, vatnode validates the number and returns the same response shape as for corporate entities. The valid field is true regardless of legal form.

Does vatnode handle VIES outages for Portugal?

vatnode caches recent VIES responses and surfaces a clear VIES_UNAVAILABLE error code with structured retry guidance. vatnode does not use a national validity fallback for Portugal — only the VAT register itself can confirm a VAT registration, so during a VIES outage validation defers to the cached result or returns the error for safe handling.

What is the consultation number returned for checks in Portugal?

The consultationNumber is the VIES requestIdentifier — a unique reference issued by the EU VIES service that proves the check was performed against the official EU register on a specific date. It is the EU's documented mechanism for "reasonable care" evidence under the reverse-charge rules and is returned once you set your own VAT as requester in dashboard Settings — including for Portugal.

More on Portugal

VAT APIs for Other EU Countries

See Also

Building an AI workflow? vatnode is also available to AI agents through the official MCP server — Claude, Cursor and ChatGPT can validate Portugal VAT numbers and look up rates directly in chat.

Start Validating Portugal VAT Numbers

100 validations per month on the free plan, no credit card required. REST JSON over HTTPS, VIES consultation number on qualified checks, EU-hosted by default.

Get a free API keyPortugal VAT format referenceQuickstart