Create Quote

Creates a new quote for a client. The quote number is auto-generated and expiry defaults to 30 days.

POST /api/v1/quotes

cURL

curl -X POST https://kliio.app/api/v1/quotes \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "client_id": "c1d2e3f4-...",
    "amount": 3500,
    "currency": "USD",
    "tax_rate": 10,
    "expires_at": "2025-04-30",
    "description": "E-commerce site build",
    "line_items": [
      { "description": "Design", "quantity": 1, "rate": 1500 },
      { "description": "Development", "quantity": 20, "rate": 100 }
    ]
  }'

201

{
  "success": true,
  "data": {
    "id": "quo-uuid-...",
    "quote_number": "QUO-0013",
    "amount": 3500,
    "currency": "USD",
    "status": "Draft",
    "expires_at": "2025-04-30",
    "tax_rate": 10,
    "description": "E-commerce site build",
    "client": {
      "id": "c1d2e3f4-...",
      "name": "Alice Johnson",
      "email": "[e-mail]",
      "company_name": "Acme Corp"
    },
    "created_at": "2025-03-15T10:30:00.000Z"
  }
}

Headers

Authorization · string · required

Bearer YOUR_API_KEY

Body

client_id · string · required

UUID of the client. Must belong to your account.

amount · number · required

Total quote amount (must be ≥ 0).

project_id · string

Optional UUID of an associated project.

expires_at · string

Valid until date in YYYY-MM-DD format. Defaults to 30 days from creation.

description · string

A short description or scope of work.

currency · string

3-letter currency code. Defaults to USD.

tax_rate · number

Tax rate as a percentage (0–100). Defaults to 0.

status · string

Initial status. Either Draft (default) or Sent.

line_items · array

Optional array of line items.

Show Line item object

description · string · required

Line item label

quantity · number · required

Quantity

rate · number · required

Unit price

discount · number

Discount percentage (0–100). Defaults to 0.

Response

success · boolean

true on creation.

data · object

The newly created quote, including an embedded client object.

cURL

curl -X POST https://kliio.app/api/v1/quotes \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "client_id": "c1d2e3f4-...",
    "amount": 3500,
    "currency": "USD",
    "tax_rate": 10,
    "expires_at": "2025-04-30",
    "description": "E-commerce site build",
    "line_items": [
      { "description": "Design", "quantity": 1, "rate": 1500 },
      { "description": "Development", "quantity": 20, "rate": 100 }
    ]
  }'

201

{
  "success": true,
  "data": {
    "id": "quo-uuid-...",
    "quote_number": "QUO-0013",
    "amount": 3500,
    "currency": "USD",
    "status": "Draft",
    "expires_at": "2025-04-30",
    "tax_rate": 10,
    "description": "E-commerce site build",
    "client": {
      "id": "c1d2e3f4-...",
      "name": "Alice Johnson",
      "email": "[e-mail]",
      "company_name": "Acme Corp"
    },
    "created_at": "2025-03-15T10:30:00.000Z"
  }
}