Klnzr — Professional Cleaning

Authentication

Every request must include your API key in the Authorization header:

Authorization: Bearer YOUR_API_KEY_HERE

API keys are issued and rotated by AllClean. Contact info@klnzr.com to request or rotate a key. Never expose your key in client-side code or logs.

Base URL

https://klnzr.fly.dev

GET /api/v1/orders

Returns orders assigned to your supplier account, newest first.

Query Parameters

Parameter	Type	Default	Description
status	string	—	Filter by order status (see values below)
limit	integer	100	Max records to return (max 500)
offset	integer	0	Records to skip, for pagination

Order Status Values

Value	Meaning
pending	Order placed, awaiting supplier action
awaiting_approval	Supplier quoted; waiting on customer approval
confirmed	Customer approved; service is scheduled
in_progress	Service currently being performed
completed	Service done
cancelled	Cancelled by customer
declined	Declined by supplier

Example Request

curl -X GET "https://klnzr.fly.dev/api/v1/orders?status=confirmed&limit=50" \
  -H "Authorization: Bearer YOUR_API_KEY_HERE"

Example Response

{
  "data": [
    {
      "id": "550e8400-e29b-41d4-a716-446655440000",
      "order_number": 1042,
      "status": "confirmed",
      "scheduled_at": "2026-05-10T09:00:00Z",
      "completed_at": null,
      "address": "123 Main St, Cairo",
      "service_type_id": "a1b2c3d4-...",
      "price": "150.00",
      "amount_due": "150.00",
      "payment_method": "digital",
      "notes": null,
      "customer_notes": "Please call before arriving",
      "driver_id": null,
      "supplier_branch_id": null,
      "inserted_at": "2026-05-07T10:30:00Z",
      "updated_at": "2026-05-07T11:00:00Z"
    }
  ],
  "meta": {
    "count": 1,
    "limit": 50,
    "offset": 0
  }
}

Pagination

Use limit and offset to page through results:

# Page 1
GET /api/v1/orders?limit=100&offset=0

# Page 2
GET /api/v1/orders?limit=100&offset=100

Error Responses

All errors return JSON with a single error field:

{"error": "description of the problem"}

HTTP Status	Cause
400	Invalid query parameter (e.g. unknown status value)
401	Missing or invalid API key
500	Internal server error

Supplier API