Fiscal

Use our Fiscal product to access invoices, tax compliance statuses, tax returns, and tax statuses from the fiscal authority in a given country.

We refer to links created with a fiscal institutions (such as Mexico's SAT) as fiscal links.

Invoices

Our Invoices endpoint let you retrieve the electronic of an invoice, uploaded to the fiscal institution's website, that a business or individual has received or sent. You can retrieve multiple INFLOW (received) and OUTFLOW (sent) invoices for each fiscal institution link.

We offer the following methods when it comes to interacting with Invoices:

Endpoints

Method

Description

Retrieve

POST

Retrieve invoices information from a specific fiscal link.

List

GET

List of all existing invoices in your Belvo account.

Detail

GET

Get the details of a specific invoice.

Destroy

DELETE

Delete a specific invoice from your Belvo account.

📘

SAT imposes limits on the number of invoices you can download per day. For more information, as well as potential workarounds, see our help center article.

Tax compliance status

Our Tax compliance status endpoint lets you retrieve information about whether a person or business is complying with their tax obligations at the moment of your request. The information is extracted from SAT's Opinion de cumplimiento de Obligaciones Fiscales document.

We offer the following methods when it comes to interacting with Tax compliance statuses:

Endpoints

Method

Description

Retrieve

POST

Retrieve the Tax compliance status information from a specific fiscal link.

List

GET

A list of all existing Tax compliance statuses in your Belvo account.

Detail

GET

Get the details of a specific Tax compliance status.

Destroy

DELETE

Delete a specific Tax compliance status from your Belvo account.

Tax returns

Our Tax returns endpoint let you retrieve the electronic representation of the tax return document sent every year by a person or a business to the tax authority in the country.

📘

The tax return data structure will be different depending on if it is related to a person or a business (you will find examples for both in the API reference).

We offer the following methods when it comes to interacting with Tax returns:

Endpoints

Method

Description

Retrieve

POST

Retrieve tax return information from a specific fiscal link.

List

GET

List of all existing tax returns in your Belvo account.

Detail

GET

Get the details of a specific tax return.

Destroy

DELETE

Delete a specific tax return from your Belvo account.

Tax status

Our Tax status endpoint lets you retrieve information about a person's or business's tax situation, according to the country's tax authority. The information is extracted from SAT's Constancia de situación fiscal document.

📘

The tax status data structure will be different depending on if it is related to a person or a business.

We offer the following methods when it comes to interacting with Tax statuses:

Endpoints

Method

Description

Retrieve

POST

Retrieve tax status information from a specific fiscal link.

List

GET

List of all existing tax status in your Belvo account.

Detail

GET

Get the details of a specific tax status.

Destroy

DELETE

Delete a specific tax status from your Belvo account.

Updated about a month ago


Fiscal


Use our Fiscal product to access invoices, tax compliance statuses, tax returns, and tax statuses from the fiscal authority in a given country.

We refer to links created with a fiscal institutions (such as Mexico's SAT) as fiscal links.

Suggested Edits are limited on API Reference Pages

You can only suggest edits to Markdown body content, but not to the API spec.