Skip to main content

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.

PostmanTry it in Postman

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:

HeaderDescription
emailYour API user email
tokenYour 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​

EndpointMethodDescription
TaxId ValidationGET /api/v1.1/taxIdValidationCheck that a tax id is valid for a country
Activation SetPOST /api/v2.1/taxCommunication/activationSetTurn Tax Communication on or off
Activation GetGET /api/v2.1/taxCommunication/activationGetCheck whether Tax Communication is on
List DocumentsPOST /api/v2.1/taxCommunication/communicationListList 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.