Recurring invoices

A recurring invoice is a template. When it fires, Rebill creates a real invoice from it and sends it to the client. Recurring invoices must be activated before they start generating invoices.

GET /recurring_invoice

curl https://api.rebill.co.za/recurring_invoice \
  -H "Authorization: Bearer sk_your_secret_key"

Response:

{
  "recurring_invoices": [
    {
      "id": "ri001",
      "active": true,
      "client_id": "xyz789",
      "currency": "ZAR",
      "interval": "month",
      "interval_amount": 1,
      "start_date": "2026-01-01T00:00:00Z",
      "next_date": "2026-04-01T00:00:00Z",
      "items": [...]
    }
  ]
}

GET /recurring_invoice/:id

Returns a single recurring invoice by ID.

When the interval is month or year, the monthly_anchor field controls exactly which day of the month each invoice is generated:

POST /recurring_invoice

curl -X POST https://api.rebill.co.za/recurring_invoice \
  -H "Authorization: Bearer sk_your_secret_key" \
  -H "Content-Type: application/json" \
  -d '{
    "client_id": "xyz789",
    "start_date": "2026-04-01",
    "interval": "month",
    "interval_amount": 1,
    "due_interval": "day",
    "due_interval_amount": 14,
    "currency": "ZAR",
    "items": [
      {
        "type": "service",
        "name": "Monthly retainer",
        "description": "Ongoing consulting retainer",
        "quantity": 1,
        "unit_price": 1500000,
        "vat_type": "standard",
        "vat_rate": 1500
      }
    ]
  }'

Response (201 Created):

{
  "id": "ri001"
}

By default the recurring invoice is created inactive; you must activate it before it starts generating invoices. Set activate_immediately: true to skip that step.

PUT /recurring_invoice/:id

Updates a recurring invoice. Accepts the same fields as create.

DELETE /recurring_invoice/:id

Permanently deletes a recurring invoice. Returns 200 OK on success.

PUT /recurring_invoice/:id/labels

Replaces the recurring invoice's internal label list. Works while the schedule is active; labels are operator-only metadata and nothing else on the schedule changes.

curl -X PUT https://api.rebill.co.za/recurring_invoice/ri001/labels \
  -H "Authorization: Bearer sk_your_secret_key" \
  -H "Content-Type: application/json" \
  -d '{
    "labels": ["retainer"]
  }'

PUT /recurring_invoice/:id/activate

Activates the schedule. Once active, Rebill will generate and send invoices on the configured cadence starting from the start_date.

curl -X PUT https://api.rebill.co.za/recurring_invoice/ri001/activate \
  -H "Authorization: Bearer sk_your_secret_key"

PUT /recurring_invoice/:id/deactivate

Pauses the schedule. No new invoices will be generated until the recurring invoice is activated again. Existing generated invoices are not affected.

curl -X PUT https://api.rebill.co.za/recurring_invoice/ri001/deactivate \
  -H "Authorization: Bearer sk_your_secret_key"