API reference

API reference

All endpoints of version 1. Click a resource for its fields, filters and examples.

Base URL
$QUILO_URL/api/v1
Authentication
Authorization: Bearer qk_…
Format
JSON · UTF-8 · HTTPS

Machine-readable: openapi.json (OpenAPI 3.1). Import it into Postman, Insomnia or a code generator.

Me

GET/meWho this key acts as

Clients

People and companies who buy from you, with contact details, preferences (ring size, metal, stones, style) and dates.

GET/clientsList clients
POST/clientsCreate a client
GET/clients/{id}Get a client
PATCH/clients/{id}Change a client
DELETE/clients/{id}Delete a client

Sales

What clients bought: date, receipt number, items and total. A receipt number is unique per brand.

GET/salesList sales
POST/salesCreate a sale
GET/sales/{id}Get a sale
PATCH/sales/{id}Change a sale
DELETE/sales/{id}Delete a sale

Custom orders

Made-to-order pieces moving through stages from inquiry to won or lost.

GET/custom-ordersList custom orders
POST/custom-ordersCreate a custom order
GET/custom-orders/{id}Get a custom order
PATCH/custom-orders/{id}Change a custom order
DELETE/custom-orders/{id}Delete a custom order

Appointments

Visits, calls and fittings. Appointments created through the API are marked with source "api".

GET/appointmentsList appointments
POST/appointmentsCreate a appointment
GET/appointments/{id}Get a appointment
PATCH/appointments/{id}Change a appointment
DELETE/appointments/{id}Delete a appointment

Tasks & follow-ups

To-dos and follow-ups, optionally linked to a client.

GET/tasksList tasks & follow-ups
POST/tasksCreate a task
GET/tasks/{id}Get a task
PATCH/tasks/{id}Change a task
DELETE/tasks/{id}Delete a task

Invoices

Invoices with Swiss QR-bill reference (read only in v1). GET /invoices/{id} includes the lines.

GET/invoicesList invoices
GET/invoices/{id}Get a invoice

Brands

The brands (shops, labels) of the company that you can access. Use their IDs as brand_id.

GET/brandsList brands
GET/brands/{id}Get a brand
Terminal
curl "$QUILO_URL/api/v1/openapi.json" -o quilo-openapi.json