List all tax returns

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

🔦 Filterable fields

FieldAvailable Filters
created_at gt, gte, lt, lte, range
id=, in
informacion_general__ejercicio=, gt, gte, lt, lte, range
informacion_general__tipo_declaracion=, in
link=, in
# 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&informacion_general__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!