← API documentation

Inkoop API

Content
GET /purchases

Retrieve purchases

Returns a paginated list of purchases, newest first.

Parameter Description
customer_id Filter by supplier.
from, to Purchases between two dates.
page, page_size Pagination, default 15 per page.
Request
curl "https://financial.gyvex.com/api/purchases?from=2026-01-01" \
  -H "Accept: application/json" \
  -H "Authorization: Bearer UW_API_SLEUTEL"
GET /purchases/{purchase}

Retrieve purchase

Returns a purchase with lines. Add ?customer for the supplier details. Use the purchase's slug in the URL.

Request
curl "https://financial.gyvex.com/api/purchases/a1b2c3?customer" \
  -H "Accept: application/json" \
  -H "Authorization: Bearer UW_API_SLEUTEL"
POST /purchase/store

Create purchase

Registers a purchase from a supplier. On success you receive status 201.

Field Required Description
purchase_date Yes Date of the purchase.
customer_id Yes ID of the supplier (one of your contacts).
total_amount Yes Total amount.
vat No VAT amount.
Request
curl -X POST "https://financial.gyvex.com/api/purchase/store" \
  -H "Accept: application/json" \
  -H "Authorization: Bearer UW_API_SLEUTEL" \
  -H "Content-Type: application/json" \
  -d '{"purchase_date": "2026-11-18", "customer_id": 12, "total_amount": 121.00, "vat": 21.00}'
PUT /purchase/{purchase}/update

Update purchase

Updates a purchase. Only the fields you send are changed.

Request
curl -X PUT "https://financial.gyvex.com/api/purchase/a1b2c3/update" \
  -H "Accept: application/json" \
  -H "Authorization: Bearer UW_API_SLEUTEL" \
  -H "Content-Type: application/json" \
  -d '{"total_amount": 150.00}'
DELETE /purchase/{purchase}

Delete purchase

Deletes a purchase. On success you receive status 204.

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