Update Invoice

Updates one or more fields on an existing invoice.

PATCH /api/v1/invoices/{id}

cURL

curl -X PATCH https://kliio.app/api/v1/invoices/inv-uuid-... \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "status": "Paid" }'

200

{
  "success": true,
  "data": {
    "id": "inv-uuid-...",
    "invoice_number": "INV-0042",
    "status": "Paid",
    "amount": 1500.00,
    "currency": "USD",
    "due_date": "2025-04-30",
    "created_at": "2025-03-15T10:30:00.000Z"
  }
}

Headers

Authorization · string · required

Bearer YOUR_API_KEY

Path Parameters

id · string · required

UUID of the invoice to update.

Body

Send only the fields you want to change. At least one field is required.

status · string

New status. One of: Draft, Sent, Paid, Overdue, Cancelled.

description · string

Updated invoice description.

due_date · string

Updated due date in YYYY-MM-DD format.

amount · number

Updated total amount.

currency · string

Updated 3-letter currency code.

tax_rate · number

Updated tax rate as a percentage (0–100).

Response

success · boolean

true on update.

data · object

The updated invoice object.

cURL

curl -X PATCH https://kliio.app/api/v1/invoices/inv-uuid-... \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "status": "Paid" }'

200

{
  "success": true,
  "data": {
    "id": "inv-uuid-...",
    "invoice_number": "INV-0042",
    "status": "Paid",
    "amount": 1500.00,
    "currency": "USD",
    "due_date": "2025-04-30",
    "created_at": "2025-03-15T10:30:00.000Z"
  }
}