List all invoices

Get a paginated list of all existing invoices in your Belvo account. We return up to 100 results per page.

🔦 Filterable fields

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

FieldAvailable Filters
created_at gt, gte, lt, lte, range
id=, in
invoice_date=, gt, gte, lt, lte, range
invoice_identification=, gt, gte, lt, lte, range
link=, in
status=, in
total_amount=, gt, gte, lt, lte, range
type=, in
# Filtering results so that you get Tax Returns from one link:
https://sandbox.belvo.com/api/invoices/?link=link-id

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

//  Filtering results so that you get the Tax Returns from two links
// and are of type normal and their status is vigente:
client.invoices.list({
  filters: {
    link__in: "link-id-1, link-id-2",
    informacion_general__tipo_declaracion: "Normal",
    status: "vigente"
  }
})
# Filtering results so that you get the Tax Return from one link:
client.invoices.list(link="link-id")

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


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