← API documentation

Periodieke facturen API

Content
GET /invoice-schedules

Retrieve recurring invoices

Returns your recurring invoices (repeating invoice schedules), sorted by the next invoice date.

Parameter Description
page, page_size Pagination, default 15 per page.
Request
curl "https://financial.gyvex.com/api/invoice-schedules" \
  -H "Accept: application/json" \
  -H "Authorization: Bearer UW_API_SLEUTEL"
GET /invoice-schedules/{id}

Retrieve recurring invoice

Returns a recurring invoice with customers and lines.

Request
curl "https://financial.gyvex.com/api/invoice-schedules/3" \
  -H "Accept: application/json" \
  -H "Authorization: Bearer UW_API_SLEUTEL"
POST /invoice-schedule/store

Create recurring invoice

Creates a recurring invoice. For each customer an invoice with the given lines is created every period.

Field Required Description
name Yes Name or reference.
frequency Yes monthly, quarterly or yearly.
next_billing_date Yes Date of the next invoice.
customers Yes List of customer IDs that are invoiced periodically.
items Yes List of lines (see below).
items[].description Yes Description of the line.
items[].quantity Yes Quantity, whole number, at least 1.
items[].unit_price Yes Price per unit, excl. VAT.
Request
curl -X POST "https://financial.gyvex.com/api/invoice-schedule/store" \
  -H "Accept: application/json" \
  -H "Authorization: Bearer UW_API_SLEUTEL" \
  -H "Content-Type: application/json" \
  -d '{"name": "Hosting", "frequency": "monthly", "next_billing_date": "2026-12-01", "customers": [7], "items": [{"description": "Hosting", "quantity": 1, "unit_price": 25}]}'
PUT /invoice-schedule/{id}/update

Update recurring invoice

Updates a recurring invoice. Send all fields: the customers and lines are replaced entirely.

Request
curl -X PUT "https://financial.gyvex.com/api/invoice-schedule/3/update" \
  -H "Accept: application/json" \
  -H "Authorization: Bearer UW_API_SLEUTEL" \
  -H "Content-Type: application/json" \
  -d '{"name": "Hosting", "frequency": "yearly", "next_billing_date": "2027-01-01", "customers": [7], "items": [{"description": "Hosting", "quantity": 1, "unit_price": 275}]}'
DELETE /invoice-schedule/{id}

Delete recurring invoice

Stops the schedule. Invoices already created remain. On success you receive status 204.

Request
curl -X DELETE "https://financial.gyvex.com/api/invoice-schedule/3" \
  -H "Accept: application/json" \
  -H "Authorization: Bearer UW_API_SLEUTEL"

Need help with your integration?

Create a ticket via "My Gyvex" in your dashboard. With Premium you get priority support, with a reply within 24 hours.