Tax status (Webhooks)
Reference information for our Tax status webhook events.
Historical update
As soon as your fiscal link is created, we asynchronously retrieve the Tax Status (Constancia de Situación Fiscal) document and will send you the following webhook:
Webhook Code | Description |
---|---|
historical_update | The latest Tax Status for the user. |
In the webhook payload you will receive the total number of Tax Status documents for the user along with the last date that the Tax Status was updated.
{
"webhook_id": "03d1ca0d62db4f769488265d141047b7",
"webhook_type": "TAX_STATUS",
"webhook_code": "historical_update",
"process_type": "historical_update",
"link_id": "2f5d361d-dad6-45d4-a0bf-26d479766067",
"request_id": "4363b08b-51eb-4350-9c74-5df5ac92a7f6",
"external_id": "your_external_id",
"data": {
"total_tax_status": 1, // Number of tax statuses
"last_status_change_date": "1995-08-01" // Year when the tax status was last changed
}
}
Once you receive the notification, you can get further details by making the following request:
curl --request GET \
-u [Secret Key ID]:[Secret Key PASSWORD] \
'https://api.belvo.com/api/tax-status/?link=link_id'
Query Parameter | Description | Example |
---|---|---|
link | The link_id you received in the webhook notification. | 2f5d361d-dad6-45d4-a0bf-26d479766067 |
For details about the response body, make sure to check out our List Tax Status API reference documentation or Tax Status Data Dictionary.
Updated about 2 months ago