---
title: "List tax returns"
method: GET
path: "/api/tax-returns/"
tags: ["Tax returns"]
---

# List tax returns

`GET /api/tax-returns/`

## ▶️ Usage

 With the List Tax Returns method, you can:

  1. List tax returns related to a specific `link.id` (using the `link` query parameter).
  2. Get the details of a specific `tax-return.id` (using the `id` query parameter).
  3. **[Not Recommended]** List all tax returns 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 `page_size` query parameter to increase the number of items returned to a maximum of 1000 items. You can use the `page` query parameter to navigate through the results. For more details on how to navigate Belvo's paginated responses, see our <a href="https://developers.belvo.com/docs/belvo-pagination-tips" target="_blank">Pagination Tips</a> 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 <a href="https://developers.belvo.com/docs/searching-and-filtering" target="_blank">Filtering responses</a> article.

  ## 🔔 Multiple Schemas

  As a link can have both yearly and monthly tax returns, the response will include a mix of these two types of tax returns (and thus difference schemas).

## Query parameters

- `link` string, uuid
- `page_size` integer
- `page` integer
- `omit` string
- `fields` string
- `link__in` string[]
- `id` string, uuid
- `id__in` string[]
- `created_at` string, date
- `created_at__gt` string, date
- `created_at__gte` string, date
- `created_at__lt` string, date
- `created_at__lte` string, date
- `created_at__range` string[]
- `ejercicio` integer
- `ejercicio__lt` integer
- `ejercicio__lte` integer
- `ejercicio__gt` integer
- `ejercicio__gte` integer
- `ejercicio__range` integer[]
- `tipo_declaracion` string
- `tipo_declaracion__in` string[]

## Response `200`

Ok

- object
  - `count` integer — The total number of results in your Belvo account.
  - `next` string, uri, nullable — 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 `null`. In our documentation example, we use `{endpoint}` as a placeholder value. In production, this value will be replaced by the actual endpoint you are currently using (for example, `accounts` or `owners`).
  - `previous` string, uri, nullable — The URL to the previous page of results. If there is no previous page, the value is `null`.
  - `results` union[] — An array of: - Tax Return Personal (Yearly) objects - Tax Return Personal (Monthly) objects - Tax Return Business (Yearly) objects - Tax Return Business (Monthly) objects > 🚧 Multiple Schemas > > As a link can have both yearly and monthly tax returns, the response will include a mix of these two types of tax returns (and thus difference schemas).
    - union
      - TaxReturnPersonal
        - `id` string, uuid — Belvo's unique identifier for the current item.
        - `link` string, uuid, nullable — 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 — The ISO-8601 timestamp of when the data point was created in Belvo's database.
        - `informacion_general` object, nullable, required — General information on the tax return (year, RFC, return type, person/company name, and so on).
        - `sueldos_salarios` object, nullable, required — Details regarding the income information together combined with withheld taxes.
        - `servicios_profesionales` object, nullable, required — Details regarding the income and tax information from professional services provided.
        - `deducciones_personales` object, nullable, required — List of all personal tax deductions.
        - `determinacion_impuesto` object, nullable, required — Details regarding the final tax return.
        - `retenciones` object, nullable, required — Details on the already withheld taxes.
        - `dividendos` object, nullable, required — Details regarding dividends.
        - `datos_informativos` object, nullable — Extra informative data on the tax return.
        - `pdf` string, binary, nullable, required — Tax return PDF as a binary.
        - `receipt_pdf` string, binary, nullable, required — The acknowledgement receipt from the fiscal institution confirming that they received the tax return.
      - TaxReturnPersonalMonthly
        - `id` string, uuid — Belvo's unique identifier for the current item.
        - `collected_at` string, date-time, required — The ISO-8601 timestamp when the data point was collected.
        - `created_at` string, date-time — The ISO-8601 timestamp of when the data point was created in Belvo's database.
        - `informacion_general` object, nullable, required — General information regarding the tax return (year, RFC, return type, person/company name, and so on).
        - `isr` object, nullable, required — Information used to calculate the monthly provisional payments of the income tax.
        - `iva` object, nullable, required — Information used to calculate the monthly provisional payments of the VAT tax.
        - `pdf` string, binary, nullable, required — Tax return PDF as a binary.
        - `receipt_pdf` string, binary, nullable — The acknowledgement receipt from the fiscal institution confirming that they received the tax return.
        - `type` string, required — The type of tax return. Can be either monthly or annual.
      - TaxReturnBusiness
        - `id` string, uuid, required — Belvo's unique identifier for the current item.
        - `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.
        - `informacion_general` object, nullable, required — General information regarding the tax return (year, RFC, return type, person/company name, and so on).
        - `datos_adicionales` object, nullable, required — Additional data regarding the tax return.
        - `estado_resultados` object, nullable, required — Detailed information about the legal entity's yearly profit and loss. > **Note**: For tax returns submitted for the 2022 tax year and later, this field will return null as it is no longer a required field when submitting your tax return.
        - `estado_posicion_financiera_balance` object, nullable, required — Details regarding balance sheet of the legal entity. > **Note**: For tax returns submitted for the 2022 tax year and later, this field will return null as it is no longer a required field when submitting your tax return.
        - `conciliacion_entre_resultado_contable_fiscal` object, nullable, required — Details regarding the accounting reconciliation. > **Note**: For tax returns submitted for the 2022 tax year and later, this field will return null as it is no longer a required field when submitting your tax return.
        - `deducciones_autorizadas` object, nullable, required — Details regarding the legal entity's deductions.
        - `cifras_cierre_ejercicio` object, nullable, required — Details regarding key numbers at the end of the fiscal exercise.
        - `determinacion_del_impuesto_sobre_la_renta` object, nullable, required — Details regarding the final tax return.
        - `dividendos_o_utilidades_distribuidos` object, nullable, required — Details regarding distributed dividends.
        - `detalle_pago_r1_isr_personas_morales` object, nullable, required — Details of the tax payment.
        - `ingressos` object, nullable — > **Note**: Only applicable for tax return filed on or after 2022. For tax returns filed before 2022, this field will return `null`. Details regarding the total amounts earned in the fiscal year.
        - `determinacion` object, nullable — > **Note**: Only applicable for tax return filed on or after 2022. For tax returns filed before 2022, this field will return `null`. Details regarding the tax due or tax credit.
        - `pdf` string, binary, nullable, required — Tax return PDF as a binary.
        - `receipt_pdf` string, binary, nullable, required — The acknowledgement receipt from the fiscal institution confirming that they received the tax return.
      - TaxReturnBusinessMonthly
        - `id` string, uuid — Belvo's unique identifier for the current item.
        - `collected_at` string, date-time, required — The ISO-8601 timestamp when the data point was collected.
        - `created_at` string, date-time — The ISO-8601 timestamp of when the data point was created in Belvo's database.
        - `informacion_general` object, nullable, required — General information regarding the tax return (year, RFC, return type, person/company name, and so on).
        - `determinacion_isr` object, nullable, required — Information used to calculate the provisional income tax for the period.
        - `detalle_pago_isr` object, nullable, required — Information on the monthly provisional payments for the income tax.
        - `determinacion_iva` object, nullable, required — Information used to calculate the provisional VAT tax for the period.
        - `detalle_pago_iva` object, nullable, required — Information on the monthly provisional payments for the VAT tax.
        - `pdf` string, binary, nullable, required — Tax return PDF as a binary.
        - `receipt_pdf` string, binary, nullable — The acknowledgement receipt from the fiscal institution confirming that they received the tax return.
        - `type` string, nullable, required — The type of tax return. Can be either monthly or annual.

## 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/revisions/e82dca4a4b97/schema)