Skip to main content

TaxId Validation

Checks whether a tax id is valid for a country. Use it to catch a mistyped tax id before you create a document or add a partner with it.

It only answers valid or not valid: it doesn't return any data about the company.

RESTGET https://bo.magnifinance.com/api/v1.1/taxIdValidation
SOAPTaxIdValidation on https://bo.magnifinance.com/MagniAPI/v1.1/Invoicing.asmx

Postman Try it in Postman​

Each request is in a ready-made Postman collection, one for each API:

  • REST: download the collection, or paste this URL in Postman's Import:
    https://developer.magnifinance.com/finance/postman/taxid-validation-rest.json
  • SOAP: download the collection, or paste this URL in Postman's Import:
    https://developer.magnifinance.com/finance/postman/taxid-validation-soap.json

Import it, fill in email and token in its Variables tab (see Authentication) and press Send; change the taxId variable to try an invalid one.

Supported countries​

Today only Portugal (PT) is supported. Any other country code returns ElementDoesNotExist (6), which means the country isn't supported, not that the tax id is wrong.

Result​

ResultMeaning
SuccessThe tax id is valid.
InvalidTaxId (4)The tax id isn't valid for that country.
ElementDoesNotExist (6)The country isn't supported.
ValidationError (2)taxId or countryCode is missing.
AuthenticationError (1)The email or token is wrong.

Any subscription token works; you don't need a special permission.