Sign in
Clients - Protected

Look up a NIF/VAT in the EU VIES registry

Resolve a NIF/VAT into the registered trader's name and parsed address.

Read-only, no DB access — async handler is safe here (no pyodbc work) and keeps the blocking external call off the shared threadpool.

get/api/clients/vies-lookup

Query parameters

nifstring required

PT NIF (9 digits) or EU VAT with country prefix (e.g. ESB85937712)

PT NIF (9 digits) or EU VAT with country prefix (e.g. ESB85937712)

Headers

x-api-tokenstring nullable

Response

Successful Response

availableboolean required
foundboolean
validboolean nullable
countrystring nullable
namestring nullable
moradastring nullable
codigo_postalstring nullable
localidadestring nullable
cidadestring nullable
paisstring nullable

Changes

No recorded changes to this endpoint across all 1 revision of this API.