---
title: "Get a tax status's details"
method: GET
path: "/api/tax-status/{id}/"
tags: ["Tax status"]
---

# Get a tax status's details

`GET /api/tax-status/{id}/`

Get the details of a specific tax status.

## Path parameters

- `id` string, uuid, required

## Query parameters

- `omit` string
- `fields` string

## Response `200`

Ok

- TaxStatusSat
  - `id` string, uuid, required — Belvo's unique identifier for the current item.
  - `link` string, uuid, nullable, required — The `link.id` the data belongs to.
  - `collected_at` string, date-time, required — The ISO-8601 timestamp when the data point was collected.
  - `created_at` string, date-time, required — The ISO-8601 timestamp of when the data point was created in Belvo's database.
  - `place_and_date_of_issuance` string, nullable, required — The place and date of that the tax status was issued.
  - `official_name` string, nullable, required — The name of the person or business.
  - `id_cif` string, nullable, required — The taxpayer's *Cédula de Identificación Fiscal* (CIF) ID.
  - `tax_payer_information` TaxStatusTaxPayerInformationSat, nullable, required — Details regarding the taxpayer.
    - `rfc` string, nullable, required — The tax payers's identification number (For Mexico, this is the RFC).
    - `curp` string, nullable — The tax payers's *Clave Única de Registro de Población* (CURP) number.
    - `name` string, nullable — The tax payers's first name.
    - `first_last_name` string, nullable — The tax payers's first last name.
    - `second_last_name` string, nullable — The tax payers's second last name.
    - `start_operations_date` string, date, nullable, required — Date when the tax payer commenced taxable commercial activities, in `YYYY-MM-DD` format.
    - `status_padron` string, nullable, required — Status of the taxpayer in the Federal Register of Taxpayers (RFC). Can be `ACTIVO` or `INACTIVO`.
    - `last_status_change_date` string, date, nullable, required — Date when `status_padron` was most recently updated, in `YYYY-MM-DD` format.
    - `commercial_name` string, nullable — The name of the business designated for consumers and the general public. **Note**: Only applicable for businesses.
    - `social_name` string, nullable — The unique and exclusive name within the national territory that companies receive for legal or administrative purposes. **Note**: Only applicable for businesses.
    - `email` string, nullable — Contact email address for the tax payer.
    - `phone` string, nullable — Contact phone number for the tax payer.
  - `address` TaxStatusAddressSat, nullable, required — The tax payer's address details.
    - `postal_code` string, nullable, required — The postcode of the address.
    - `street_type` string, nullable — The `street` type.
    - `street` string, nullable — The tax payers street.
    - `exterior_number` string, nullable — The street number.
    - `interior_number` string, nullable — Additional address information.
    - `suburb` string, nullable — The suburb of the tax payer.
    - `locality` string, nullable — The locality of the address.
    - `municipality` string, nullable — The municipality of the address.
    - `state` string, nullable — The state that the address is in.
    - `between_street` TaxStatusAddressBetweenStreetSat[], nullable — Additional information about where the `street` is located.
      - `street_one` string, nullable — The first street that `street` is located between.
      - `street_two` string, nullable — The second street that `street` is located between.
  - `economic_activity` TaxStatusEconomicActivitySat[], nullable, required — A list of economic activity objects.
    - `economic_activity` string, nullable — The description of the economic activity.
    - `initial_date` string, nullable — The start date of the economic activity, in `YYYY-MM-DD` format.
    - `end_date` string, date, nullable — The end date of the economic activity, in `YYYY-MM-DD` format.
    - `order` string, nullable — The order of the economic activity.
    - `percentage` string, nullable — The percentage of the economic activity.
  - `regimes` TaxStatusRegimensSat[], nullable, required — A list of regimen objects.
    - `end_date` string, date, nullable, required — The end date of the regimen, in `YYYY-MM-DD` format.
    - `initial_date` string, date, nullable, required — The start date of the regimen, in `YYYY-MM-DD` format.
    - `regimen` string, nullable, required — The description of the regimen.
  - `obligations` TaxStatusObligationsSat[], nullable, required — Details regarding a business's obligations. ℹ️ For non-business accounts, this field will return empty.
    - `obligation` string, nullable — The description of the obligation.
    - `expiration` string, nullable — The deadline to fulfill the obligation, as imposed by the tax authority.
    - `initial_date` string, date, nullable — The date when obligation started, in `YYYY-MM-DD` format.
    - `end_date` string, date, nullable — The date when obligation ended, in `YYYY-MM-DD` format.
  - `digital_stamp` string, nullable, required — The validation certificate of the document.
  - `digital_stamp_chain` string, 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).
  - `pdf` string, binary, nullable, required — Tax status PDF as a binary string.

## Other responses

- `401` — Unauthorized
- `403` — Access to Belvo API denied
- `404` — Not Found Error
- `408` — Request Timeout
- `428` — MFA Token Required
- `500` — Unexpected Error

---

[API](https://skmtc.net/belvo/apis/belvo-api-docs.md) · [All operations](https://skmtc.net/belvo/apis/belvo-api-docs/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/belvo/belvo-api-docs/versions/3423c786ece5/schema)