---
title: "Changes to Gets a list of recurring_expenses"
method: GET
path: "/api/v1/recurring_expenses"
---

# Changes to Gets a list of recurring_expenses

`GET /api/v1/recurring_expenses`

> Every recorded change to this operation, newest first.

## Timeline

Changed in 13 of 110 revisions.

- **2026-05-06** `89876e7e51d6`: 1 info
- **2026-04-20** `69a36036d334`: 3 info
- **2025-11-22** `00ad5cc89fad`: 12 info
- **2025-05-24** `93bb427f804b`: 1 breaking
- **2024-06-06** `8e82a2bd77e0`: 2 breaking, 41 info
- **2024-06-05** `e61df65649e2`: 2 breaking, 41 warning
- **2024-03-07** `71171a40d629`: 5 breaking, 46 info
- **2024-02-18** `88bbc1f38ff7`: 5 breaking, 47 warning
- **2024-02-10** `4ad0fff44c6c`: 1 breaking, 4 info
- **2024-01-24** `9dab078a46b5`: 1 info
- **2024-01-20** `70cd94370516`: 1 breaking
- **2023-07-08** `627936439128`: 4 breaking, 39 warning, 2 info
- **2023-02-18** `ab767c581aef`: 2 info

## Changes

- **2026-05-06** `89876e7e51d6`: 1 info
  - added the new optional `query` request parameter `sort`
- **2026-04-20** `69a36036d334`: 3 info
  - added the new optional `query` request parameter `page`
  - added the new optional `query` request parameter `per_page`
  - the response optional property `data/items/id` became read-only for the status `200`
- **2025-11-22** `00ad5cc89fad`: 12 info
  - added the optional property `data/items/calculate_tax_by_amount` to the response with the `200` status
  - added the optional property `data/items/category_id` to the response with the `200` status
  - added the optional property `data/items/currency_id` to the response with the `200` status
  - added the optional property `data/items/next_send_date_client` to the response with the `200` status
  - added the optional property `data/items/number` to the response with the `200` status
  - added the optional property `data/items/project_id` to the response with the `200` status
  - added the optional property `data/items/tax_amount1` to the response with the `200` status
  - added the optional property `data/items/tax_amount2` to the response with the `200` status
  - added the optional property `data/items/tax_amount3` to the response with the `200` status
  - added the optional property `data/items/transaction_id` to the response with the `200` status
  - added the optional property `data/items/uses_inclusive_taxes` to the response with the `200` status
  - added the optional property `data/items/vendor_id` to the response with the `200` status
- **2025-05-24** `93bb427f804b`: 1 breaking
  - the `meta` response's property type changed from `object` to no type for status `200`
- **2024-06-06** `8e82a2bd77e0`: 2 breaking, 41 info
  - the response's body type changed from no type to `object` for status `default`
  - the `data/items/` response's property type changed from no type to `object` for status `200`
  - added the optional property `code` to the response with the `default` status
  - added the optional property `data/items/amount` to the response with the `200` status
  - added the optional property `data/items/archived_at` to the response with the `200` status
  - added the optional property `data/items/assigned_user_id` to the response with the `200` status
  - added the optional property `data/items/bank_id` to the response with the `200` status
  - added the optional property `data/items/client_id` to the response with the `200` status
  - added the optional property `data/items/custom_value1` to the response with the `200` status
  - added the optional property `data/items/custom_value2` to the response with the `200` status
  - added the optional property `data/items/custom_value3` to the response with the `200` status
  - added the optional property `data/items/custom_value4` to the response with the `200` status
  - added the optional property `data/items/date` to the response with the `200` status
  - added the optional property `data/items/exchange_rate` to the response with the `200` status
  - added the optional property `data/items/expense_currency_id` to the response with the `200` status
  - added the optional property `data/items/foreign_amount` to the response with the `200` status
  - added the optional property `data/items/frequency_id` to the response with the `200` status
  - added the optional property `data/items/id` to the response with the `200` status
  - added the optional property `data/items/invoice_category_id` to the response with the `200` status
  - added the optional property `data/items/invoice_currency_id` to the response with the `200` status
  - added the optional property `data/items/invoice_documents` to the response with the `200` status
  - added the optional property `data/items/invoice_id` to the response with the `200` status
  - added the optional property `data/items/is_deleted` to the response with the `200` status
  - added the optional property `data/items/last_sent_date` to the response with the `200` status
  - added the optional property `data/items/next_send_date` to the response with the `200` status
  - added the optional property `data/items/payment_date` to the response with the `200` status
  - added the optional property `data/items/payment_type_id` to the response with the `200` status
  - added the optional property `data/items/private_notes` to the response with the `200` status
  - added the optional property `data/items/public_notes` to the response with the `200` status
  - added the optional property `data/items/remaining_cycles` to the response with the `200` status
  - added the optional property `data/items/should_be_invoiced` to the response with the `200` status
  - added the optional property `data/items/tax_name1` to the response with the `200` status
  - added the optional property `data/items/tax_name2` to the response with the `200` status
  - added the optional property `data/items/tax_name3` to the response with the `200` status
  - added the optional property `data/items/tax_rate1` to the response with the `200` status
  - added the optional property `data/items/tax_rate2` to the response with the `200` status
  - added the optional property `data/items/tax_rate3` to the response with the `200` status
  - added the optional property `data/items/transaction_reference` to the response with the `200` status
  - added the optional property `data/items/transcation_id` to the response with the `200` status
  - added the optional property `data/items/updated_at` to the response with the `200` status
  - …3 more
- **2024-06-05** `e61df65649e2`: 2 breaking, 41 warning
  - the response's body type changed from `object` to no type for status `default`
  - the `data/items/` response's property type changed from `object` to no type for status `200`
  - removed the optional property `code` from the response with the `default` status
  - removed the optional property `data/items/amount` from the response with the `200` status
  - removed the optional property `data/items/archived_at` from the response with the `200` status
  - removed the optional property `data/items/assigned_user_id` from the response with the `200` status
  - removed the optional property `data/items/bank_id` from the response with the `200` status
  - removed the optional property `data/items/client_id` from the response with the `200` status
  - removed the optional property `data/items/custom_value1` from the response with the `200` status
  - removed the optional property `data/items/custom_value2` from the response with the `200` status
  - removed the optional property `data/items/custom_value3` from the response with the `200` status
  - removed the optional property `data/items/custom_value4` from the response with the `200` status
  - removed the optional property `data/items/date` from the response with the `200` status
  - removed the optional property `data/items/exchange_rate` from the response with the `200` status
  - removed the optional property `data/items/expense_currency_id` from the response with the `200` status
  - removed the optional property `data/items/foreign_amount` from the response with the `200` status
  - removed the optional property `data/items/frequency_id` from the response with the `200` status
  - removed the optional property `data/items/id` from the response with the `200` status
  - removed the optional property `data/items/invoice_category_id` from the response with the `200` status
  - removed the optional property `data/items/invoice_currency_id` from the response with the `200` status
  - removed the optional property `data/items/invoice_documents` from the response with the `200` status
  - removed the optional property `data/items/invoice_id` from the response with the `200` status
  - removed the optional property `data/items/is_deleted` from the response with the `200` status
  - removed the optional property `data/items/last_sent_date` from the response with the `200` status
  - removed the optional property `data/items/next_send_date` from the response with the `200` status
  - removed the optional property `data/items/payment_date` from the response with the `200` status
  - removed the optional property `data/items/payment_type_id` from the response with the `200` status
  - removed the optional property `data/items/private_notes` from the response with the `200` status
  - removed the optional property `data/items/public_notes` from the response with the `200` status
  - removed the optional property `data/items/remaining_cycles` from the response with the `200` status
  - removed the optional property `data/items/should_be_invoiced` from the response with the `200` status
  - removed the optional property `data/items/tax_name1` from the response with the `200` status
  - removed the optional property `data/items/tax_name2` from the response with the `200` status
  - removed the optional property `data/items/tax_name3` from the response with the `200` status
  - removed the optional property `data/items/tax_rate1` from the response with the `200` status
  - removed the optional property `data/items/tax_rate2` from the response with the `200` status
  - removed the optional property `data/items/tax_rate3` from the response with the `200` status
  - removed the optional property `data/items/transaction_reference` from the response with the `200` status
  - removed the optional property `data/items/transcation_id` from the response with the `200` status
  - removed the optional property `data/items/updated_at` from the response with the `200` status
  - …3 more
- **2024-03-07** `71171a40d629`: 5 breaking, 46 info
  - the response's body type changed from no type to `object` for status `401`
  - the response's body type changed from no type to `object` for status `403`
  - the response's body type changed from no type to `object` for status `422`
  - the response's body type changed from no type to `object` for status `default`
  - the `data/items/` response's property type changed from no type to `object` for status `200`
  - added the optional property `code` to the response with the `default` status
  - added the optional property `data/items/amount` to the response with the `200` status
  - added the optional property `data/items/archived_at` to the response with the `200` status
  - added the optional property `data/items/assigned_user_id` to the response with the `200` status
  - added the optional property `data/items/bank_id` to the response with the `200` status
  - added the optional property `data/items/client_id` to the response with the `200` status
  - added the optional property `data/items/custom_value1` to the response with the `200` status
  - added the optional property `data/items/custom_value2` to the response with the `200` status
  - added the optional property `data/items/custom_value3` to the response with the `200` status
  - added the optional property `data/items/custom_value4` to the response with the `200` status
  - added the optional property `data/items/date` to the response with the `200` status
  - added the optional property `data/items/exchange_rate` to the response with the `200` status
  - added the optional property `data/items/expense_currency_id` to the response with the `200` status
  - added the optional property `data/items/foreign_amount` to the response with the `200` status
  - added the optional property `data/items/frequency_id` to the response with the `200` status
  - added the optional property `data/items/id` to the response with the `200` status
  - added the optional property `data/items/invoice_category_id` to the response with the `200` status
  - added the optional property `data/items/invoice_currency_id` to the response with the `200` status
  - added the optional property `data/items/invoice_documents` to the response with the `200` status
  - added the optional property `data/items/invoice_id` to the response with the `200` status
  - added the optional property `data/items/is_deleted` to the response with the `200` status
  - added the optional property `data/items/last_sent_date` to the response with the `200` status
  - added the optional property `data/items/next_send_date` to the response with the `200` status
  - added the optional property `data/items/payment_date` to the response with the `200` status
  - added the optional property `data/items/payment_type_id` to the response with the `200` status
  - added the optional property `data/items/private_notes` to the response with the `200` status
  - added the optional property `data/items/public_notes` to the response with the `200` status
  - added the optional property `data/items/remaining_cycles` to the response with the `200` status
  - added the optional property `data/items/should_be_invoiced` to the response with the `200` status
  - added the optional property `data/items/tax_name1` to the response with the `200` status
  - added the optional property `data/items/tax_name2` to the response with the `200` status
  - added the optional property `data/items/tax_name3` to the response with the `200` status
  - added the optional property `data/items/tax_rate1` to the response with the `200` status
  - added the optional property `data/items/tax_rate2` to the response with the `200` status
  - added the optional property `data/items/tax_rate3` to the response with the `200` status
  - …11 more
- **2024-02-18** `88bbc1f38ff7`: 5 breaking, 47 warning
  - the response's body type changed from `object` to no type for status `401`
  - the response's body type changed from `object` to no type for status `403`
  - the response's body type changed from `object` to no type for status `422`
  - the response's body type changed from `object` to no type for status `default`
  - the `data/items/` response's property type changed from `object` to no type for status `200`
  - removed the optional property `code` from the response with the `default` status
  - removed the optional property `data/items/amount` from the response with the `200` status
  - removed the optional property `data/items/archived_at` from the response with the `200` status
  - removed the optional property `data/items/assigned_user_id` from the response with the `200` status
  - removed the optional property `data/items/bank_id` from the response with the `200` status
  - removed the optional property `data/items/client_id` from the response with the `200` status
  - removed the optional property `data/items/company_id` from the response with the `200` status
  - removed the optional property `data/items/custom_value1` from the response with the `200` status
  - removed the optional property `data/items/custom_value2` from the response with the `200` status
  - removed the optional property `data/items/custom_value3` from the response with the `200` status
  - removed the optional property `data/items/custom_value4` from the response with the `200` status
  - removed the optional property `data/items/date` from the response with the `200` status
  - removed the optional property `data/items/exchange_rate` from the response with the `200` status
  - removed the optional property `data/items/expense_currency_id` from the response with the `200` status
  - removed the optional property `data/items/foreign_amount` from the response with the `200` status
  - removed the optional property `data/items/frequency_id` from the response with the `200` status
  - removed the optional property `data/items/id` from the response with the `200` status
  - removed the optional property `data/items/invoice_category_id` from the response with the `200` status
  - removed the optional property `data/items/invoice_currency_id` from the response with the `200` status
  - removed the optional property `data/items/invoice_documents` from the response with the `200` status
  - removed the optional property `data/items/invoice_id` from the response with the `200` status
  - removed the optional property `data/items/is_deleted` from the response with the `200` status
  - removed the optional property `data/items/last_sent_date` from the response with the `200` status
  - removed the optional property `data/items/next_send_date` from the response with the `200` status
  - removed the optional property `data/items/payment_date` from the response with the `200` status
  - removed the optional property `data/items/payment_type_id` from the response with the `200` status
  - removed the optional property `data/items/private_notes` from the response with the `200` status
  - removed the optional property `data/items/public_notes` from the response with the `200` status
  - removed the optional property `data/items/remaining_cycles` from the response with the `200` status
  - removed the optional property `data/items/should_be_invoiced` from the response with the `200` status
  - removed the optional property `data/items/tax_name1` from the response with the `200` status
  - removed the optional property `data/items/tax_name2` from the response with the `200` status
  - removed the optional property `data/items/tax_name3` from the response with the `200` status
  - removed the optional property `data/items/tax_rate1` from the response with the `200` status
  - removed the optional property `data/items/tax_rate2` from the response with the `200` status
  - …12 more
- **2024-02-10** `4ad0fff44c6c`: 1 breaking, 4 info
  - the `meta/pagination/links` response's property type changed from `array` to `object` for status `200`
  - added the media type `application/json` for the response with the status `401`
  - added the media type `application/json` for the response with the status `403`
  - added the media type `application/json` for the response with the status `422`
  - added the media type `application/json` for the response with the status `default`
- **2024-01-24** `9dab078a46b5`: 1 info
  - endpoint added
- **2024-01-20** `70cd94370516`: 1 breaking
  - api path removed without deprecation
- **2023-07-08** `627936439128`: 4 breaking, 39 warning, 2 info
  - removed the media type `application/json` for the response with the status `401`
  - removed the media type `application/json` for the response with the status `403`
  - removed the media type `application/json` for the response with the status `422`
  - removed the media type `application/json` for the response with the status `default`
  - removed the optional property `amount` from the response with the `200` status
  - removed the optional property `archived_at` from the response with the `200` status
  - removed the optional property `assigned_user_id` from the response with the `200` status
  - removed the optional property `bank_id` from the response with the `200` status
  - removed the optional property `client_id` from the response with the `200` status
  - removed the optional property `company_id` from the response with the `200` status
  - removed the optional property `custom_value1` from the response with the `200` status
  - removed the optional property `custom_value2` from the response with the `200` status
  - removed the optional property `custom_value3` from the response with the `200` status
  - removed the optional property `custom_value4` from the response with the `200` status
  - removed the optional property `date` from the response with the `200` status
  - removed the optional property `exchange_rate` from the response with the `200` status
  - removed the optional property `expense_currency_id` from the response with the `200` status
  - removed the optional property `foreign_amount` from the response with the `200` status
  - removed the optional property `frequency_id` from the response with the `200` status
  - removed the optional property `id` from the response with the `200` status
  - removed the optional property `invoice_category_id` from the response with the `200` status
  - removed the optional property `invoice_currency_id` from the response with the `200` status
  - removed the optional property `invoice_documents` from the response with the `200` status
  - removed the optional property `invoice_id` from the response with the `200` status
  - removed the optional property `is_deleted` from the response with the `200` status
  - removed the optional property `last_sent_date` from the response with the `200` status
  - removed the optional property `next_send_date` from the response with the `200` status
  - removed the optional property `payment_date` from the response with the `200` status
  - removed the optional property `payment_type_id` from the response with the `200` status
  - removed the optional property `private_notes` from the response with the `200` status
  - removed the optional property `public_notes` from the response with the `200` status
  - removed the optional property `remaining_cycles` from the response with the `200` status
  - removed the optional property `should_be_invoiced` from the response with the `200` status
  - removed the optional property `tax_name1` from the response with the `200` status
  - removed the optional property `tax_name2` from the response with the `200` status
  - removed the optional property `tax_name3` from the response with the `200` status
  - removed the optional property `tax_rate1` from the response with the `200` status
  - removed the optional property `tax_rate2` from the response with the `200` status
  - removed the optional property `tax_rate3` from the response with the `200` status
  - removed the optional property `transaction_reference` from the response with the `200` status
  - …5 more
- **2023-02-18** `ab767c581aef`: 2 info
  - added the non-success response with the status `401`
  - added the non-success response with the status `403`

---

[Operation](https://skmtc.dev/invoiceninja/apis/invoice-ninja-api-reference/docs/api/v1/recurring_expenses/get.md) - [API](https://skmtc.dev/invoiceninja/apis/invoice-ninja-api-reference.md) - [Page](https://skmtc.dev/invoiceninja/apis/invoice-ninja-api-reference/changes/api/v1/recurring_expenses/get)
