List all tax returns

Get a paginated list of all existing tax returns in your Belvo account. By default, we return up to 100 results per page. The results will include a mix of both monthly and yearly tax returns.

🔦 Filterable fields

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.

# Filtering results so that you get Tax Returns from one link:
https://api.belvo.com/api/tax-returns/?link=link-id

# Filtering results so that you get Tax Returns from two links and are of type normal:
https://api.belvo.com/api/tax-returns/?link__in=link-id1,link-id2&tipo_declaracion=Normal,
//  Filtering results so that you get the Tax Returns from one link:
client.taxReturns.list({
  filters: {
    link: "link-id"
  }
})

//  Filtering results so that you get the Tax Returns from two links and are of type normal:
client.taxReturns.list({
  filters: {
    link__in: "link-id-1, link-id-2",
    informacion_general__tipo_declaracion: "Normal"
  }
})

# Filtering results so that you get the Tax Return from one link:
client.TaxReturns.list(link="link-id")

# Filtering results so that you get the Tax Returns from two links and are of type normal:
client.TaxReturns.list(link__in="link-id1,link-id2", informacion_general__tipo_declaracion: "Normal")
# Filtering results so that you get the Tax Return from one link:
client.tax_returns.list(params: {
  link: "link-id"
})


# Filtering results so that you get the Tax Returns from two links and are of type normal:
client.tax_returns.list(params: {
  link__in: "link-id1, link-id1",
  informacion_general__tipo_declaracion: "Normal"
})
Language
Authentication
Basic
base64
:
URL
Click Try It! to start a request and see the response here!