Sign in

v1

latestOpenAPI 3.0.22026-08-061464031.4 MB
Tax status

Get a tax status's details

Get the details of a specific tax status.

get/api/tax-status/{id}/

Path parameters

idstring uuid required

The tax-status.id you want to get detailed information about.

Query parameters

omitstring

Omit certain fields from being returned in the response. For more information, see our <a href="https://developers.belvo.com/docs/searching-and-filtering" target="_blank">Filtering responses</a> DevPortal article.

fieldsstring

Return only the specified fields in the response. For more information, see our <a href="https://developers.belvo.com/docs/searching-and-filtering" target="_blank">Filtering responses</a> DevPortal article.

Response

Ok

idstring uuid required

Belvo's unique identifier for the current item.

linkstring uuid nullable required

The link.id the data belongs to.

collected_atstring date-time required

The ISO-8601 timestamp when the data point was collected.

created_atstring date-time required

The ISO-8601 timestamp of when the data point was created in Belvo's database.

place_and_date_of_issuancestring nullable required

The place and date of that the tax status was issued.

official_namestring nullable required

The name of the person or business.

id_cifstring nullable required

The taxpayer's Cédula de Identificación Fiscal (CIF) ID.

digital_stampstring nullable required

The validation certificate of the document.

digital_stamp_chainstring nullable required

A data chain containing the basic structure of a fiscal digital check. For Mexico, this is the Comprobante Fiscal Digital por Internet (CFDI).

pdfstring binary nullable required

Tax status PDF as a binary string.

Example response

{
  "id": "0d3ffb69-f83b-456e-ad8e-208d0998d71d",
  "link": "30cb4806-6e00-48a4-91c9-ca55968576c8",
  "collected_at": "2022-02-09T08:45:50.406032Z",
  "created_at": "2022-02-09T08:45:50.406032Z",
  "place_and_date_of_issuance": "TLALPAN , CIUDAD DE MEXICO A 19 DE MARZO DE 2020",
  "official_name": "John Doe",
  "id_cif": "12345678901",
  "tax_payer_information": {
    "rfc": "BEMP12345G58",
    "name": "JOHN",
    "first_last_name": "DOE",
    "second_last_name": "SCHMOE",
    "commercial_name": "Jar Jar Transport",
    "social_name": "John Doe SA DE CV",
    "email": "john_doe@gmail.com",
    "phone": "1234567890"
  },
  "address": {
    "postal_code": "21255",
    "street_type": "CALLE",
    "street": "LA MALINCHE",
    "exterior_number": "432",
    "interior_number": "PLANTA BAJA",
    "suburb": "BUENAVENTURA",
    "locality": "none",
    "municipality": "CDMX DC",
    "state": "Federal",
    "between_street": [
      {
        "street_one": "CALLE PRINCIPE",
        "street_two": "CALLE NUEVA ROMA"
      }
    ]
  },
  "economic_activity": [
    {
      "economic_activity": "Asalariado",
      "initial_date": "2020-12-06",
      "order": "2",
      "percentage": "1"
    }
  ],
  "regimes": [
    {
      "initial_date": "2020-12-06",
      "regimen": "Régimen de Ingresos por Dividendos (socios y accionistas)"
    }
  ],
  "obligations": [
    {
      "obligation": "Declaración informativa de IVA con la anual de ISR",
      "expiration": "Conjuntamente con la declaración anual del ejercicio.",
      "initial_date": "2020-12-06"
    }
  ],
  "digital_stamp": "||2020/04/26|GHTF980303F7|CONSTANCIA DE SITUACIÓN\nFISCAL|2044441088666600000034||\n",
  "digital_stamp_chain": "EtenSA9t1adG7bn+Jj23kj43JK+XbMPxdOppwabhXD+pXseSqYowWWDna0mpUk3264lkj2345j23faNZB852dCDt9KAjow=\n",
  "pdf": "=PDF-STRING="
}