PUT https://app.alaaqat.com/api/invoices/{invoice_id}
Where invoice_id is the invoice's _id. Changes the property values you send and leaves the others as they are. Your API key needs the invoice-update ability, and the team member who created the key needs Edit Invoices.
{
"Accept": "application/json",
"Content-Type": "application/json"
}
The same property values as Create an Invoice: each key is a property's internal_name, and each value must match its type. Send only the properties you want to change. To empty a value, send null.
{
"status": "paid"
}
Leave items out to keep the line items as they are. When you send items, the list you send replaces the current one, so include every line you want to keep, each with its name, unit_price and quantity.
Alaaqat works out the amount again on every update. See Line items and the amount.
200 OK, with the whole invoice under data.
{
"data": {
"properties": {
"_id": "6657c1d2e3f4a5b6c7d8e901",
"title": "Office chairs, October order",
"status": "paid",
"currency": "JOD",
"discount_rate": 5,
"tax_rate": 16,
"invoice_number": "INV-1001",
"amount": 523.45,
"created_by": 12,
"updated_at": "2026-10-21T08:40:12.000000Z",
"created_at": "2026-10-20T09:30:00.000000Z"
},
"account_id": 1024,
"items": [
{
"net_price": 440,
"name": "Ergonomic office chair",
"unit_price": 120,
"quantity": 4,
"description": "Black mesh back",
"unit_discount": 10,
"tax_rate": 0
},
{
"net_price": 35,
"name": "Delivery and assembly",
"unit_price": 35,
"quantity": 1,
"description": null,
"unit_discount": 0,
"tax_rate": 0
}
]
},
"message": "Entity was modified successfully."
}
| Status | Meaning |
|---|---|
| 403 | The team member who created the key can only change the invoices they or their teams own, and this one isn't. |
| 404 | No invoice with this _id in your account. |
| 422 | A value does not match its property's type, or a field that Alaaqat sets was sent. |