# List tax statuses

## ▶️ Usage

With the Tax Status method, you can:

1. List tax statuses related to a specific  (using the  query parameter).
2. Get the details of a specific  (using the  query parameter).
3.  List all tax statuses related to your Belvo account (without using any query parameters).

## 📖 Pagination

This method returns a paginated response (default: 100 items per page). You can use the  query parameter to increase the number of items returned to a maximum of 1000 items. You can use the  query parameter to navigate through the results. For more details on how to navigate Belvo's paginated responses, see our Pagination Tips article.

## 🔦 Filtering Responses

Please see the query list below for a list of fields that you can filter your responses by. For more information on how to use filters, see our Filtering responses article.


Endpoint: GET /api/cl/tax-status/
Version: 1.222.0
Security: basicAuth

## Query parameters:

  - `link` (string)
    The  you want to filter by.

ℹ️ We highly recommend adding the  filter in order to improve your performance.
    Example: "8848bd0c-9c7e-4f53-a732-ec896b11d4c4"

  - `page_size` (integer)
    Indicates how many results to return per page. By default we return 100 results per page.

ℹ️ The minimum number of results returned per page is 1 and the maximum is 1000. If you enter a value greater than 1000, our API will default to the maximum value (1000).
    Example: 100

  - `page` (integer)
    A page number within the paginated result set.
    Example: 1

  - `omit` (string)
    Omit certain fields from being returned in the response. For more information, see our Filtering responses DevPortal article.

  - `fields` (string)
    Return only the specified fields in the response. For more information, see our Filtering responses DevPortal article.

  - `link__in` (array)
    Return results only for these s.
    Example: ["5722d0ba-69d7-42dc-8ff5-33767b83c5d6"]

  - `id` (string)
    Return information only for this resource .
    Example: "24ccab1d-3a86-4136-a6eb-e04bf52b356f"

  - `id__in` (array)
    Return information for these resource s.
    Example: ["6b3dea0f-be29-49d1-aabe-1a6d588642e6"]

  - `created_at` (string)
    Return items that were last updated in Belvo's database on this date (in  format).
    Example: "2022-05-05"

  - `created_at__gt` (string)
    Return items that were last updated in Belvo's database after this date (in  format).
    Example: "2022-05-05"

  - `created_at__gte` (string)
    Return items that were last updated in Belvo's database after or on this date (in  format).
    Example: "2022-05-04"

  - `created_at__lt` (string)
    Return items that were last updated in Belvo's database before this date (in  format).
    Example: "2022-04-01"

  - `created_at__lte` (string)
    Return items that were last updated in Belvo's database before or on this date (in  format).
    Example: "2022-03-30"

  - `created_at__range` (array)
    Return accounts that were last updated in Belvo's database between two dates (in  format).
    Example: ["2022-03-03"]

## Response 200 fields (application/json):

  - `count` (integer)
    The total number of results in your Belvo account.
    Example: 130

  - `next` (string,null)
    The URL to next page of results. Each page consists of up to 100 items. If there are not enough results for an additional page, the value is .

In our documentation example, we use  as a placeholder value. In production, this value will be replaced by the actual endpoint you are currently using (for example,  or ).
    Example: "https://sandbox.belvo.com/api/{endpoint}/?link=1bd948f7-245d-4313-b604-34d1044cb908page=2"

  - `previous` (string,null)
    The URL to the previous page of results. If there is no previous page, the
value is .

  - `results` (array)
    Array of tax status objects.

  - `results.id` (string)
    Belvo's unique identifier for the current item.
    Example: "0d3ffb69-f83b-456e-ad8e-208d0998d71d"

  - `results.link` (string,null)
    The  the data belongs to.
    Example: "30cb4806-6e00-48a4-91c9-ca55968576c8"

  - `results.collected_at` (string)
    The ISO-8601 timestamp when the data point was collected.
    Example: "2022-02-09T08:45:50.406032Z"

  - `results.created_at` (string)
    The ISO-8601 timestamp of when the data point was created in Belvo's database.
    Example: "2022-02-09T08:45:50.406032Z"

  - `results.entity_details` (object)
    Details regarding the fiscal entity's (key dates and identification information).

  - `results.entity_details.incorporation_date` (string, required)
    The date that the fiscal entity was incorporated, in  format.
    Example: "24-09-2010"

  - `results.entity_details.start_date` (string, required)
    The date that the fiscal entity started operating, in  format.
    Example: "24-09-2010"

  - `results.entity_details.end_date` (string,null, required)
    The date that the fiscal entity ceased operations, in  format. If the entity is still operating, this field will return

  - `results.entity_details.document_id_type` (string, required)
    The type of document ID that the fiscal entity has. For Chile, this will be the .
    Example: "RUT"

  - `results.entity_details.document_id_number` (string, required)
    The document ID number of the fiscal entity.
    Example: "197476427-K"

  - `results.entity_details.name` (string, required)
    The name of the fiscal entity.
    Example: "Empresa de Prueba"

  - `results.addresses` (array)
    An array of addresses for the fiscal entity.

  - `results.addresses.type` (string, required)
    The type of address. Can be either:

  -  ()
  -  ()
  -  ()
  -  ()
    Enum: "PRIMARY", "SECONDARY", "MAILING_ADDRESS", "NOTIFICATION_ADDRESS"

  - `results.addresses.date` (string, required)
    The date that the address was added to the fiscal entity's records, in  format.
    Example: "24-09-2010"

  - `results.addresses.address` (string, required)
    The address of the fiscal entity.
    Example: "Calle Falsa 123"

  - `results.emails` (array)
    An array of email addresses for the fiscal entity.

  - `results.emails.type` (string, required)
    The type of email. Can be either:

-  ()
-  ()
- .
    Enum: "CONTACT", "NOTIFICATION", "OTHER"

  - `results.emails.email` (string, required)
    The email address of the fiscal entity.
    Example: "mi-email@empresa.cl"

  - `results.phone_numbers` (array)
    An array of phone numbers for the fiscal entity.

  - `results.phone_numbers.type` (string,null, required)
    The type of phone number. Can be either:
  
  - 
  - 
  -
    Enum: "LANDLINE", "MOBILE", "OTHER", "null"

  - `results.phone_numbers.number` (string, required)
    The phone number of the fiscal entity.
    Example: 123456789

  - `results.economic_activities` (array)
    An array of economic activities for the fiscal entity.

  - `results.economic_activities.type` (string, required)
    The overall economic activity type, according to Servicio de Impuestos Internos (SII).
    Example: "ASESORIA EN INGENIERIA"

  - `results.economic_activities.activity` (string, required)
    The specific economic activity, according to Servicio de Impuestos Internos (SII).
    Example: "ACTIVIDADES DE CONSULTORIA DE GESTION"

  - `results.economic_activities.code` (string, required)
    The economic activity code, according to Servicio de Impuestos Internos (SII).
    Example: "702000"

  - `results.economic_activities.tax_category` (integer, required)
    The tax category of the economic activity, according to Servicio de Impuestos Internos (SII).
    Example: 1

  - `results.economic_activities.vat_affected` (boolean, required)
    Indicates whether the economic activity is VAT-affected.
    Example: true

  - `results.economic_activities.start_date` (string, required)
    The date that the fiscal entity started this economic activity, in  format.
    Example: "24-09-2010"

  - `results.legal_representative` (array)
    An array of legal representatives for the fiscal entity.

  - `results.legal_representative.is_current` (boolean, required)
    Indicates whether the legal representative is the current legal representative of the fiscal entity.
    Example: true

  - `results.legal_representative.name` (string, required)
    The name of the legal representative.
    Example: "Juan Perez"

  - `results.legal_representative.document_id_type` (string, required)
    The type of document ID of the legal representative. For Chile, this will be always set to .
    Enum: "RUT"

  - `results.legal_representative.document_id_number` (string, required)
    The document ID number of the legal representative. For Chile, this will be the RUT number.
    Example: "12345678-9"

  - `results.legal_representative.start_date` (string, required)
    The date that the legal representative started representing the fiscal entity, in  format.
    Example: "24-09-2010"

  - `results.legal_representative.end_date` (string,null)
    The date that the legal representative ceased representing the fiscal entity, in  format. If the legal representative is still representing the fiscal entity, this field will return .

  - `results.equity_holders` (array)
    An array of equity holders for the fiscal entity.

  - `results.equity_holders.is_current` (boolean, required)
    Indicates whether the equity holder is currently active.
    Example: true

  - `results.equity_holders.name` (string, required)
    The name of the equity holder.
    Example: "Juan Perez"

  - `results.equity_holders.document_id_type` (string, required)
    The type of document ID of the equity holder. For Chile, this will be always set to .
    Enum: "RUT"

  - `results.equity_holders.document_id_number` (string, required)
    The document ID number of the equity holder. For Chile, this will be the RUT number.
    Example: "12345678-9"

  - `results.equity_holders.inactive` (boolean, required)
    Indicates whether the equity holder is currently inactive.

  - `results.equity_holders.start_date` (string, required)
    The date that the equity holder started holding equity in the fiscal entity, in  format.
    Example: "24-09-2010"

  - `results.equity_holders.end_date` (string,null)
    The date that the equity holder ceased holding equity in the fiscal entity, in  format. If the equity holder is still holding equity in the fiscal entity, this field will return .

  - `results.equity_holders.capital_contributed` (number, required)
    The amount of capital contributed by the equity holder.
    Example: 1000000

  - `results.equity_holders.capital_contribution_outstanding` (number, required)
    The amount of capital contribution outstanding by the equity holder.
    Example: 3750

  - `results.equity_holders.ownership_share` (number, required)
    The percentage of ownership share of the equity holder.
    Example: 25.25

  - `results.equity_holders.profit_share` (number, required)
    The percentage of profit share of the equity holder.
    Example: 31.25

  - `results.company_partnership_stakes` (array)
    An array of company partnership stakes for the fiscal entity.

  - `results.company_partnership_stakes.name` (string, required)
    The name of the entity that this fiscal entity.
    Example: "Empresa de Prueba"

  - `results.company_partnership_stakes.document_id_type` (string, required)
    The type of document ID of the business. For Chile, this will be always set to .
    Enum: "RUT"

  - `results.company_partnership_stakes.document_id_number` (string, required)
    The document ID number of the business. For Chile, this will be the RUT number.
    Example: "12345678-9"

  - `results.company_partnership_stakes.inactive` (boolean, required)
    Indicates whether the business is currently active.

  - `results.company_partnership_stakes.start_date` (string, required)
    The date that the company started holding equity in the fiscal entity, in  format.
    Example: "24-09-2010"

  - `results.company_partnership_stakes.end_date` (string,null)
    The date that the company holder ceased holding equity in the fiscal entity, in  format. If the equity holder is still holding equity in the fiscal entity, this field will return .

  - `results.company_partnership_stakes.capital_contributed` (number, required)
    The amount of capital contributed by the company.
    Example: 1000000.02

  - `results.company_partnership_stakes.capital_contribution_outstanding` (number, required)
    The amount of capital contribution outstanding by the company.
    Example: 3750.02

  - `results.company_partnership_stakes.ownership_share` (number, required)
    The percentage of ownership share of the company.
    Example: 25.25

  - `results.company_partnership_stakes.profit_share` (number, required)
    The percentage of profit share of the company.
    Example: 31.25

  - `results.regimes` (array,null)
    A list of tax regimes for the fiscal entity.

  - `results.regimes.type` (string, required)
    The tax regime type, as defined by the Servicio de Impuestos Internos (SII).
    Example: "MICRO EMPRESA"

  - `results.regimes.start_date` (string, required)
    The date that the fiscal entity started this tax regime, in  format.
    Example: "2023-01-01"

  - `results.authorized_tax_documents` (array,null)
    A list of authorized tax documents for the fiscal entity.

  - `results.authorized_tax_documents.type` (string, required)
    The type of authorized tax document, as defined by the Servicio de Impuestos Internos (SII).
    Example: "CONTABILIDAD EN HOJAS SUELTAS CON NRO.UN"

  - `results.authorized_tax_documents.document_limit` (integer, required)
    The maximum number of documents that can be issued under this authorization.
    Example: 2000

  - `results.authorized_tax_documents.authorization_date` (string, required)
    The date that the tax document and limit were established, in  format.
    Example: "2010-18-11"

  - `results.property_tax_liabilities` (array,null)
    A list of tax liabilities of a property that the entity is associated with.

  - `results.property_tax_liabilities.property_id` (string, required)
    The unique identifier of the property, according to the Servicio de Impuestos Internos (SII).
    Example: "12345"

  - `results.property_tax_liabilities.district` (string, required)
    The district where the property is located.
    Example: "NUNAO"

  - `results.property_tax_liabilities.address` (string, required)
    The address of the property.
    Example: "123 Example Street"

  - `results.property_tax_liabilities.type` (string, required)
    The type of property associated with the tax liability.
    Example: "HABITACIONAL"

  - `results.property_tax_liabilities.overdue_tax_payments` (array, required)
    A list of overdue tax payments for the property.

  - `results.property_tax_liabilities.overdue_tax_payments.year` (integer, required)
    The year for which the tax payment is overdue.
    Example: 2023

  - `results.property_tax_liabilities.overdue_tax_payments.installment` (integer, required)
    The instalment number of the overdue tax payment.
    Example: 1

  - `results.property_tax_liabilities.overdue_tax_payments.due_date` (string, required)
    The due date of the overdue tax payment, in  format.
    Example: "2023-04-30"

  - `results.property_tax_liabilities.overdue_tax_payments.amount_due` (number, required)
    The amount due for the overdue tax payment.
    Example: 19.864

  - `results.property_tax_liabilities.scheduled_tax_payments` (array, required)
    A list of scheduled tax payments for the property.

  - `results.property_tax_liabilities.scheduled_tax_payments.year` (integer, required)
    The year for which the tax payment is scheduled.
    Example: 2023

  - `results.property_tax_liabilities.scheduled_tax_payments.installment` (integer, required)
    The instalment number of the scheduled tax payment.
    Example: 1

  - `results.property_tax_liabilities.scheduled_tax_payments.due_date` (string, required)
    The due date of the scheduled tax payment, in  format.
    Example: "2023-04-30"

  - `results.property_tax_liabilities.scheduled_tax_payments.amount_due` (number, required)
    The amount due for the scheduled tax payment.
    Example: 19.864

  - `results.fiscal_office` (object)
    Details regarding fiscal office where the fiscal entity is registered.

  - `results.fiscal_office.name` (string, required)
    The name of the fiscal office where the fiscal entity is registered.
    Example: "VIÑA DEL MAR"

  - `results.fiscal_office.address` (string, required)
    The address of the fiscal office where the fiscal entity is registered.
    Example: "ARLEGUI 525, VIÑA DEL MAR"

## Response 403 fields (application/json):

  - `code` (string)
    A unique error code () that allows you to classify and handle the error programmatically.


ℹ️ Check our DevPortal for more information on how to handle 403 access_to_resource_denied.
    Example: "access_to_resource_denied"

  - `message` (string)
    A short description of the error. 


For  errors, the description is:
  
  - .
    Example: "You don't have access to this resource."

  - `request_id` (string)
    A 32-character unique ID of the request (matching a regex pattern of: ). Provide this ID when contacting the Belvo support team to accelerate investigations.
    Example: "9e7b283c6efa449c9c028a16b5c249fb"

## Response 404 fields (application/json):

  - `code` (string)
    A unique error code () that allows you to classify and handle the error programmatically.
    Example: "not_found"

  - `message` (string)
    A short description of the error.


For  errors, the description is:

  -
    Example: "Not found"

  - `request_id` (string)
    A 32-character unique ID of the request (matching a regex pattern of: ). Provide this ID when contacting the Belvo support team to accelerate investigations.
    Example: "9e7b283c6efa449c9c028a16b5c249fb"

## Response 408 fields (application/json):

  - `code` (string)
    A unique error code () that allows you to classify and handle the error programmatically.


ℹ️ Check our DevPortal for more information on how to handle 408 request_timeout errors.
    Example: "request_timeout"

  - `message` (string)
    A short description of the error. 


For  errors, the description is:
  
  - .
    Example: "The request timed out, you can retry asking for less data by changing your query parameters"

  - `request_id` (string)
    A 32-character unique ID of the request (matching a regex pattern of: ). Provide this ID when contacting the Belvo support team to accelerate investigations.
    Example: "9e7b283c6efa449c9c028a16b5c249fb"

## Response 500 fields (application/json):

  - `code` (string)
    A unique error code () that allows you to classify and handle the error programmatically.


ℹ️ Check our DevPortal for more information on how to handle 500 unexpected_error errors.
    Example: "unexpected_error"

  - `message` (string)
    A short description of the error. 


For  errors, the description is:
  
  - .
    Example: "Belvo is unable to process the request due to an internal system issue or to an unsupported response from an institution"

  - `request_id` (string)
    A 32-character unique ID of the request (matching a regex pattern of: ). Provide this ID when contacting the Belvo support team to accelerate investigations.
    Example: "9e7b283c6efa449c9c028a16b5c249fb"