---
title: "Retrieve tax returns for a link"
method: POST
path: "/api/tax-returns/"
tags: ["Tax returns"]
---

# Retrieve tax returns for a link

`POST /api/tax-returns/`

Retrieve tax return information for a specific fiscal link.

## Query parameters

- `omit` string
- `fields` string

## Request body

- union
  - TaxReturnsMonthlyRequest — Request body for monthly tax returns
    - `link` string, uuid, required — The `link.id` you want to retrieve information for.
    - `attach_pdf` boolean — When set to `true`, you will receive the PDF in binary format in the response.
    - `save_data` boolean — Indicates whether or not to persist the data in Belvo. By default, this is set to `true` and we return a 201 Created response. When set to `false`, the data won't be persisted and we return a 200 OK response.
    - `type` string, required — The type of tax return to return. For monthly tax returns, this field must be set to `monthly`.
    - `date_from` string, date, required — The date from which you want to start getting data for, in `YYYY-MM-DD` format. ⚠️ The value of `date_from` cannot be greater than `date_to`.
    - `date_to` string, date, required — The date you want to stop getting data for, in `YYYY-MM-DD` format. ⚠️ The value of `date_to` cannot be greater than today's date (in other words, no future dates).
  - TaxReturnsYearlyRequest — Request body for yearly tax returns
    - `link` string, uuid, required — The `link.id` you want to retrieve information for.
    - `attach_pdf` boolean — When set to `true`, you will receive the PDF in binary format in the response.
    - `save_data` boolean — Indicates whether or not to persist the data in Belvo. By default, this is set to `true` and we return a 201 Created response. When set to `false`, the data won't be persisted and we return a 200 OK response.
    - `type` string, required — The type of tax return to return. For yearly tax returns this must be set to `yearly`. By default, Belvo returns the yearly (annual) tax returns.
    - `year_from` string, required — The starting year you want to get data for, in `YYYY` format.
    - `year_to` string, required — The year you want to stop getting data for, in `YYYY` format.

## Response `200`

Ok (when `save_data=false`)

- union[]
  - 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

- `201` — Created (when `save_data=true`)
- `400` — Bad request error
- `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/3423c786ece5/schema)