Recurring Invoices error codes
Every public API error code emitted by Recurring Invoices, with its HTTP status, its type and a page per code.
Error codes emitted by Recurring Invoices. Each code links to its own page with the cause and the action to take.
| Code | Type | HTTP | Description |
|---|---|---|---|
invalid_frequency_interval | invalid_request_error | 422 | The interval is lower than 1, so the recurrence would never advance to a next run. |
invalid_frequency_type | invalid_request_error | 422 | The frequency is outside the catalogue daily, weekly, biweekly, monthly, bimonthly, quarterly, semiannual, annual, custom. |
invalid_holiday_handling | invalid_request_error | 422 | The holiday policy is outside the catalogue skip, before, after, same. |
invalid_recurring_invoice_id | invalid_request_error | 400 | The recurrence reference received is not a valid identifier, usually because an internal value replaced the public id. |
invalid_recurring_invoice_uuid | invalid_request_error | 400 | The recurrence identifier in the path or in the payload is not a valid UUID. |
recurring_already_active | invalid_request_error | 422 | The recurrence is already running, so there is nothing to activate. Legacy code kept for compatibility: current endpoints report this as recurring_invoice_already_active. |
recurring_invoice_already_active | invalid_request_error | 422 | The recurrence is already running. |
recurring_invoice_already_cancelled | invalid_request_error | 422 | The recurrence was already cancelled, and cancellation is terminal. |
recurring_invoice_already_paused | invalid_request_error | 422 | The recurrence is already paused, so pausing it again changes nothing. |
recurring_invoice_cancelled_cannot_resume | invalid_request_error | 422 | A cancelled recurrence cannot be resumed: cancellation closes it for good, unlike a pause. |
recurring_invoice_cannot_run | invalid_request_error | 422 | The recurrence cannot generate an invoice right now: it is not running, its cycle is over, or it lacks the data an invoice needs. error.message states the specific reason. |
recurring_invoice_has_generated_invoices | invalid_request_error | 422 | The recurrence already produced invoices, and those invoices depend on it for their traceability. |
recurring_invoice_not_found | not_found_error | 404 | The identifier does not resolve to any recurrence of the authenticated company. |
recurring_invoice_requires_at_least_one_line | invalid_request_error | 422 | The recurrence has no lines, so every generated invoice would come out empty. |
recurring_not_active | invalid_request_error | 422 | The operation needs a running recurrence and this one is paused, completed or cancelled. Legacy code kept for compatibility with older integrations. |
Related
Error codes by category
Find an error by the category that emits it.
Full reference table
All codes, HTTP statuses, types and descriptions in one reference.
Error model
Interpret the error envelope and handle errors by code.