← API documentation

Offertes API

Content
GET /quotes

Retrieve quotes

Returns a paginated list of quotes. Available filters: quote_number, status (draft, sent, accepted, rejected), date_from + date_to, total_amount_min + total_amount_max, page and page_size.

Request
curl "https://financial.gyvex.com/api/quotes?status=sent" \
  -H "Accept: application/json" \
  -H "Authorization: Bearer UW_API_SLEUTEL"
GET /quotes/{quote}

Retrieve quote

Returns a single quote with lines. Add ?customer to also include the customer details.

POST /quote/store

Create quote

Works like creating an invoice, with these differences:

  • status is draft, sent, accepted or rejected.
  • customer_id and due_date are optional. The due date must not be before the quote date.
  • The quote number is numbered automatically. You must still send the quote_number field, but the value is replaced by the next number.
  • Provide vat_percentage for every line.
Request
curl -X POST "https://financial.gyvex.com/api/quote/store" \
  -H "Accept: application/json" \
  -H "Authorization: Bearer UW_API_SLEUTEL" \
  -H "Content-Type: application/json" \
  -d '{
    "quote_number": "1",
    "date": "2026-11-18",
    "customer_id": 7,
    "status": "draft",
    "items": [
      {
        "description": "Ontwerp huisstijl",
        "quantity": 1,
        "unit_price": 750,
        "vat_percentage": 21
      }
    ]
  }'
PUT /quote/{quote}/update

Update quote

Updates a quote. As with invoices, the items you send replace all existing lines.

GET /quote/{quote}/pdf

Retrieve quote PDF

Generates the PDF of a quote. The response has the same structure as for an invoice PDF.

POST /quote/{quote}/convert

Convert quote to invoice

Creates a draft invoice from a quote, with the same customer and lines, and sets the quote to accepted. Only possible for a sent quote (sent) with a customer and at least one line. On success you receive status 201 with the new invoice.

Request
curl -X POST "https://financial.gyvex.com/api/quote/1/convert" \
  -H "Accept: application/json" \
  -H "Authorization: Bearer UW_API_SLEUTEL"
DELETE /quote/{quote}

Delete quote

Deletes a quote. On success you receive status 204 without content.

Request
curl -X DELETE "https://financial.gyvex.com/api/quote/1" \
  -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.