MUmultigest
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

Request

  • Base URL
    https://api.multigest.pt (the document declares no server; this is the origin it was published from)
  • URL
    https://api.multigest.pt/api/clients/vies-lookup
  • Auth
    API key in header x-api-token and API key in header x-origin-verify

Query parameters

nifstring required

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 operation across all 21 revisions of this API.