RECURRING_NOT

Only active recurrences allow this operation. Current status: ‹status›

Category: Invoices


HTTP status	`400` Bad Request
Retry	After fixing the cause

When it happens

The operation needs an ACTIVE recurring invoice and this one is PAUSED or COMPLETED. error.details.current_status carries its status.

How to fix it

Resume a paused recurring invoice by setting its status to ACTIVE, then try again. A completed one cannot be resumed.

Retry

Not as is: the same request fails the same way. Fix the cause described above, then send the request again, under a new Idempotency-Key if the body changed.

Returned by

The operations where this code is most likely. The list is not exhaustive.

Example response

When this error occurs, the API answers 400 Bad Request with a JSON body of this shape:

{
  "type": "https://docs.beel.es/errors/RECURRING_NOT_ACTIVE",
  "title": "RECURRING_NOT_ACTIVE",
  "detail": "Only active recurrences allow this operation. Current status: ‹status›",
  "instance": "/v1/<resource>",
  "errors": [],
  "success": false,
  "error": {
    "code": "RECURRING_NOT_ACTIVE",
    "message": "Only active recurrences allow this operation. Current status: ‹status›",
    "details": {}
  },
  "meta": {
    "timestamp": "2026-05-21T10:00:00Z",
    "request_id": "4bf92f3577b34da6a3ce929d0e0e4736"
  }
}