--- title: "Gets a new blank recurring expense object" method: GET path: "/api/v1/recurring_expenses/create" tags: ["recurring_expenses"] --- # Gets a new blank recurring expense object `GET /api/v1/recurring_expenses/create` ## Request - Base URL: `https://demo.invoiceninja.com` - URL: `https://demo.invoiceninja.com/api/v1/recurring_expenses/create` - Auth: none declared. Required headers: `X-API-TOKEN`, `X-Requested-With` - TypeScript: (a function with typed inputs; its response is checked against the schema) Returns a blank object with default values ## Query parameters - `include` string ## Headers - `X-API-TOKEN` string, required - `X-Requested-With` string, required ## Response `200` A blank recurring expense object - RecurringExpense - `id` string: The hashed id of the recurring expense - `user_id` string: The hashed id of the user who created the recurring expense - `assigned_user_id` string: The hashed id of the user assigned to this recurring expense - `client_id` string: The hashed id of the client - `invoice_id` string: The hashed id of the invoice - `bank_id` string: The id of the bank associated with this recurring expense - `invoice_currency_id` string: The currency id of the invoice associated with this recurring expense - `expense_currency_id` string: The currency id of the expense associated with this recurring expense - `invoice_category_id` string: The category id of the invoice - `payment_type_id` string: The payment type id - `private_notes` string: The recurring expense private notes - `public_notes` string: The recurring expense public notes - `transaction_reference` string: The recurring expense transaction reference - `transcation_id` string: The transaction id of the recurring expense - `custom_value1` string: Custom value field - `custom_value2` string: Custom value field - `custom_value3` string: Custom value field - `custom_value4` string: Custom value field - `tax_name1` string: The tax name - `tax_name2` string: The tax name - `tax_rate1` number, float: The tax rate - `tax_rate2` number, float: The tax rate - `tax_name3` string: The tax name - `tax_rate3` number, float: The tax rate - `amount` number, float: The total amount of the recurring expense - `frequency_id` number: The frequency this recurring expense fires - `remaining_cycles` number: The number of remaining cycles for this recurring expense - `foreign_amount` number, float: The foreign currency amount of the recurring expense - `exchange_rate` number, float: The exchange rate for the expernse - `date` string: The date of the expense - `payment_date` string: The date the expense was paid - `should_be_invoiced` boolean: Boolean flag determining if the expense should be invoiced - `is_deleted` boolean: Boolean flag determining if the recurring expense is deleted - `last_sent_date` string, date: The Date it was sent last - `next_send_date` string, date: The next send date - `invoice_documents` boolean: Boolean flag determining if the documents associated with this expense should be passed onto the invoice if it is converted to an invoice - `updated_at` number: Timestamp - `archived_at` number: Timestamp - `calculate_tax_by_amount` boolean: Flag indicating whether to calculate tax based on amount rather than percentage - `category_id` string: The unique identifier of the expense category - `currency_id` string: The unique identifier of the currency - `next_send_date_client` string, date: The next scheduled send date for the client - `number` string: The unique number assigned to this recurring expense - `project_id` string: The unique identifier of the project associated with this recurring expense - `tax_amount1` number, float: The amount of the first tax - `tax_amount2` number, float: The amount of the second tax - `tax_amount3` number, float: The amount of the third tax - `transaction_id` string: The unique identifier of the transaction - `uses_inclusive_taxes` boolean: Flag indicating whether taxes are included in the price - `vendor_id` string: The unique identifier of the vendor associated with this recurring expense ## Other responses - `401`: Authentication error - `403`: Authorization error - `422`: Validation error - `default`: Unexpected Error ## Changes - **2026-04-20** `69a36036d334`: 1 info - the response optional property `id` became read-only for the status `200` - **2025-11-22** `00ad5cc89fad`: 12 info - added the optional property `calculate_tax_by_amount` to the response with the `200` status - added the optional property `category_id` to the response with the `200` status - added the optional property `currency_id` to the response with the `200` status - added the optional property `next_send_date_client` to the response with the `200` status - …8 more - **2024-06-06** `8e82a2bd77e0`: 2 breaking, 40 info - the response's body type changed from no type to `object` for status `200` - the response's body type changed from no type to `object` for status `default` - added the optional property `amount` to the response with the `200` status - added the optional property `archived_at` to the response with the `200` status - …38 more - **2024-06-05** `e61df65649e2`: 2 breaking, 40 warning - the response's body type changed from `object` to no type for status `200` - the response's body type changed from `object` to no type for 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 - …38 more - …earlier changes not shown [Operation history](https://skmtc.dev/invoiceninja/apis/invoice-ninja-api-reference/changes/api/v1/recurring_expenses/create/get.md) --- [API](https://skmtc.dev/invoiceninja/apis/invoice-ninja-api-reference.md) - [All operations](https://skmtc.dev/invoiceninja/apis/invoice-ninja-api-reference/llms.txt) - [OpenAPI document](https://skmtc.dev/invoiceninja/apis/invoice-ninja-api-reference/revisions/bcda1f823746?raw)