Skip to content
Installer.com logo

Order statuses

Every order has exactly one status. There are three.

Status Meaning
Pending The order is live. Work is outstanding.
Done Every step is finished. Nothing more is expected.
Cancelled The order was stopped and will not be completed.

Pending

An order is Pending from the moment it is created until it is finished or cancelled. This is where an order spends nearly all of its life.

Pending says nothing about how far along the work is. An order waiting for a contractor to accept and an order waiting for a final photo are both Pending. For actual progress, look at the workflow steps on the order, not the status.

Done

An order becomes Done when the last step in its workflow is finished. It means the work is complete and documented.

Done is not a payment state. An order can be Done while a payout is still settling. Check the offer on the order for where the money is.

Cancelled

Cancelled means the order was stopped and will not be completed. Cancel when the customer withdraws, the job turns out not to be possible, or the order was created in error.

Cancelling stops the workflow. Outstanding steps stop asking for action, and anyone dispatched is notified. What has already happened stays on the order: bookings, photos and offers are kept, so the record of why it was cancelled survives.

Confirmed offers are not voided by cancelling. Settle or refund them deliberately.

Moving between statuses

Pending ──▶ Done        every workflow step finished
Pending ──▶ Cancelled   stopped by a person

An order can only leave Pending. Done and Cancelled are final: to restart work, create a new order.

Reading status over the API

The API reports status as PENDING, DONE or CANCELLED. Treat any other value as unknown rather than mapping it to a status you recognise.

Was this helpful?