Below we breakdown each section of the data returned by our Tax Status API, which allows you to retrieve information about a person's or business's tax situation, according to the country's tax authority. For SAT (Mexico), this information is extracted from the Constancia de situación fiscal document.
Core Tax Status Information
{
"id": "6de34cb3-bf0d-445d-b832-7ec7781e2c6f",
"link": "401d5a8e-79e2-472e-a1ca-8f4646f5cb24",
"collected_at": "2022-02-09T08:45:50.406032Z",
"created_at": "2022-02-09T08:46:20.406032Z",
"place_and_date_of_issuance": "BUENAVENTURA, CIUDAD DE MEXICO A 22 DE FEBRERO DE 2021",
"official_name": "Alfredo Gonzalo Robin",
"id_cif": "2274235873432",
"digital_stamp": "||2020/09/26|GHTF980303F7|CONSTANCIA DE SITUACIÓN FISCAL|2044441088666600000034||",
"digital_stamp_chain": "ExpsnSA9t1adG7bn+Jj23kj43JK+XbMPxdOppwabhXD+pXseSqYowWWDna0mpUk3264lkj2345j23faNZB852dCDt9KAjel=",
"pdf": "=PDF-STRING=",
"tax_payer_information": {}, // See the dedicated tax_payer_information section
"address": {}, // See the dedicated address section
"economic_activity": [], // See the dedicated economic_activity section
"regimes": [], // See the dedicated regimes section
"obligations": [] // See the dedicated obligations section
}
Parameter
Type
Description
Example
id
string
Belvo's unique identifier for the current item.
6de34cb3-bf0d-445d-b832-7ec7781e2c6f
link
string
The link.id the data belongs to.
401d5a8e-79e2-472e-a1ca-8f4646f5cb24
collected_at
date-time
The ISO-8601 timestamp when the data point was collected.
2022-02-09T08:45:50.406032Z
created_at
date-time
The ISO-8601 timestamp of when the data point was created in Belvo's database.
2022-02-09T08:46:20.406032Z
place_and_date_of_issuance
string
The place and date that the tax status was issued.
BUENAVENTURA, CIUDAD DE MEXICO A 22 DE FEBRERO DE 2021
official_name
string
The name of the person or business.
Alfredo Gonzalo Robin
id_cif
string
The taxpayer's Cédula de Identificación Fiscal (CIF) ID.
2274235873432
digital_stamp
string
The validation certificate of the document.
||2020/09/26|GHTF980303F7|CONSTANCIA DE SITUACIÓN FISCAL|2044441088666600000034||
digital_stamp_chain
string
A data chain containing the basic structure of a fiscal digital check. For Mexico, this is the Comprobante Fiscal Digital por Internet (CFDI).
The tax payer's identification number (For Mexico, this is the RFC).
GGTF770303G7
curp
string
The tax payer's Clave Única de Registro de Población (CURP) number.
BEMP930403HDFLLT00
name
string
The tax payer's first name.
Alfredo
first_last_name
string
The tax payer's first last name.
Gonzalo
second_last_name
string
The tax payer's second last name.
Robin
start_operations_date
string (date)
Date when the tax payer commenced taxable commercial activities, in YYYY-MM-DD format.
2000-06-01
status_padron
string
Status of the taxpayer in the Federal Register of Taxpayers (RFC). Can be ACTIVO or INACTIVO.
ACTIVO
last_status_change_date
string (date)
Date when status_padron was most recently updated, in YYYY-MM-DD format.
2000-06-01
commercial_name
string
The name of the business designated for consumers and the general public. Note: Only applicable for businesses.
Alfredo Gonzalo Robi
social_name
string
The unique and exclusive name within the national territory that companies receive for legal or administrative purposes. Note: Only applicable for businesses.
The start date of the economic activity, in YYYY-MM-DD format.
2014-11-05
end_date
string (date)
The end date of the economic activity, in YYYY-MM-DD format.
null
regimes
{
"regimes": [
{
"regimen": "Régimen de Sueldos y Salarios e Ingresos Asimilados a Salarios",
"initial_date": "2003-01-01",
"end_date": null
}
]
}
Parameter
Type
Description
Example
regimen
string
The description of the regimen.
Régimen de Sueldos y Salarios e Ingresos Asimilados a Salarios
initial_date
string (date)
The start date of the regimen, in YYYY-MM-DD format.
2003-01-01
end_date
string (date)
The end date of the regimen, in YYYY-MM-DD format.
null
obligations
{
"obligations": [
{
"obligation": "Declaración informativa de IVA con la anual de ISR",
"expiration": "Conjuntamente con la declaración anual del ejercicio.",
"initial_date": "2004-03-31",
"end_date": null
}
]
}
Parameter
Type
Description
Example
obligation
string
The description of the obligation.
Declaración informativa de IVA con la anual de ISR
expiration
string
The deadline to fulfill the obligation, as imposed by the tax authority.
Conjuntamente con la declaración anual del ejercicio.
initial_date
string (date)
The date when the obligation started, in YYYY-MM-DD format.
2004-03-31
end_date
string (date)
The date when the obligation ended, in YYYY-MM-DD format.
