Order Statuses
This page documents all possible order statuses used throughout the Definitive API. These statuses are used in order management, cancellation, and status checking endpoints.
Available Statuses
Status | Description |
---|---|
ORDER_STATUS_UNSPECIFIED | Default/unspecified status |
ORDER_STATUS_PENDING | Order is pending and waiting to be processed |
ORDER_STATUS_ACCEPTED | Order has been accepted and is being processed |
ORDER_STATUS_PARTIALLY_FILLED | Order has been partially filled |
ORDER_STATUS_FILLED | Order has been completely filled |
ORDER_STATUS_CANCELLED | Order has been cancelled |
ORDER_STATUS_REJECTED | Order was rejected |
ORDER_STATUS_TERMINATED | Order has been terminated |
Cancellable Statuses
Only orders with the following statuses can be cancelled:
ORDER_STATUS_PENDING
ORDER_STATUS_ACCEPTED
ORDER_STATUS_PARTIALLY_FILLED
Non-Cancellable Statuses
Orders with these statuses cannot be cancelled:
ORDER_STATUS_FILLED
ORDER_STATUS_CANCELLED
ORDER_STATUS_REJECTED
ORDER_STATUS_TERMINATED
Status Transitions
Orders typically follow this progression:
ORDER_STATUS_PENDING
→ Order is submittedORDER_STATUS_ACCEPTED
→ Order is accepted for processingORDER_STATUS_PARTIALLY_FILLED
→ Order is partially executedORDER_STATUS_FILLED
→ Order is completely executed
Or alternatively:
ORDER_STATUS_PENDING
→ Order is submittedORDER_STATUS_ACCEPTED
→ Order is accepted for processingORDER_STATUS_CANCELLED
→ Order is cancelled by userORDER_STATUS_REJECTED
→ Order is rejected by systemORDER_STATUS_TERMINATED
→ Order is terminated
Related Endpoints
These statuses are used in the following API endpoints: