Overview
Getting Started
Widgets
Categories
Keywords
Reviews
Users
Businesses
Businesses Search
Negotiations
Messages
Requests
On-Demand Orders
Help
Changelog
Terms and Policies
Use the Orders API to manage Thumbtack on-demand orders and tailor the on-demand product experience for both customers and businesses.
Thumbtack offers several ways to customize the on-demand experience, including:
The process of creating and managing orders relies on Orders API resources, including User, Category, Configuration, and External Order. See the API object definitions for the full list of orders-related resources.
This is what the recommended flow looks like:
Decide on the configuration for the order you’re about to create.
A Configuration is a set of parameters that define the on-demand experience.
These may include customizing the job price or requiring the business to provide proof of completion once the job is done. The list of supported on-demand settings can be found here and will continue to be updated as new features are introduced.
You can create a new order using the Create Order API. In the request, you must include the configuration defined in the previous step, along with the external order and user auxiliary information.
Optionally, you can include the schedulingWindow in the API request. When this field is provided, the order status is set to schedulingReady, and Thumbtack will send scheduling notifications to the customer. If it is not provided, the status defaults to schedulingNotReady and can later be updated.
Please contact us to ensure scheduling notifications are configured correctly in your environment.
You can modify the existing orders as needed without having to cancel and recreate them. However, after a certain point in the order lifecycle, you won’t be able to make updates to order and its metadata. This includes when the order status is proMatchComplete, jobComplete, or jobCancelled.
For more details, see Order statuses.
Similarly, you can cancel an order at any time as long as the order status is not proMatchComplete, jobComplete, or jobCancelled.
However, this does not prevent the customer from canceling the service directly on Thumbtack. Emails will be sent to the customer during each phase of the order lifecycle, and the option to cancel will always be available.
Resource | Definition |
User | Represents a customer who purchases an on-demand service through Thumbtack. |
Category | Represents the Thumbtack service category that the on-demand job belongs to (for example, Furniture Assembly or TV Mounting). |
Product | Represents the goods or items purchased by the customer, for which the Thumbtack business provides services. |
Configuration | Represents the customizations or settings that can be applied to a Thumbtack on-demand service. |
External Order | Represents an order record in your system that includes the purchased product. The value must be provided to the API as a unique identifier referencing that external order. |
An order can have the following statuses. The actions you can take on an order depend on its status.
Status | Description |
schedulingNotReady | Awaiting order shipment date and schedulingWindow to be set. |
schedulingReady | Scheduling window has been set, and the customer has received a scheduling notification. |
schedulingComplete | Customer has scheduled the service and is awaiting assignment to a business. |
proMatchComplete | A business has been assigned to the customer. No further modifications are permitted. |
jobComplete | Service has been successfully completed. |
jobCancelled | Service has been cancelled. |
Last Updated: Oct 21st, 2025