REST API for Tax Compliance
The REST API uses JSON for data exchange and standard HTTP methods. This is the recommended approach for new integrations.
Every endpoint on this page is in a ready-made Postman collection, with sample bodies filled in. Import it, set email and token in its Variables tab and press Send.
- TaxId Validation: download the collection, or paste this URL in Postman's Import:
https://developer.magnifinance.com/finance/postman/taxid-validation-rest.json - Tax Communication: download the collection, or paste this URL in Postman's Import:
https://developer.magnifinance.com/finance/postman/tax-communication-rest.json
Base URL
https://bo.magnifinance.com/api
TaxId Validation is on v1.1, Tax Communication on v2.1; the full path is on each endpoint's page.
Authentication
Include these headers in every request:
| Header | Description |
|---|---|
email | Your API user email |
token | Your subscription token |
A request without either header is answered with HTTP 401 Unauthorized. A wrong email or token is answered with HTTP 200 and an AuthenticationError (1) in the response body. See Authentication.
Available Endpoints
| Endpoint | Method | Description |
|---|---|---|
| TaxId Validation | GET /api/v1.1/taxIdValidation | Check that a tax id is valid for a country |
| Activation Set | POST /api/v2.1/taxCommunication/activationSet | Turn Tax Communication on or off |
| Activation Get | GET /api/v2.1/taxCommunication/activationGet | Check whether Tax Communication is on |
| List Documents | POST /api/v2.1/taxCommunication/communicationList | List the documents communicated to the tax authority |
Response Format
All responses use the standard JSON envelope (RequestId, Type, Object, ErrorValue, ErrorHumanReadable, ValidationErrors, IsSuccess, IsError) described in Responses. Type is 0 on success and 1 on error; see Error Codes for the error list.