> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://developer.ordergroove.com/llms.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://developer.ordergroove.com/_mcp/server.

# Order Status Codes

An order's `status` — whether you filter on it or read it back from the API — is a numeric code describing the order's current condition.

| Code | Enum                                     | Description                                                                                                                                                                                                                                                                   |
| ---- | ---------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `1`  | `UNSENT`                                 | A future order that will be processed when its place date arrives.                                                                                                                                                                                                            |
| `3`  | `REJECTED`                               | The order was rejected after the retry limit was reached.                                                                                                                                                                                                                     |
| `4`  | `CANCELLED`                              | The order was cancelled before it was successfully processed.                                                                                                                                                                                                                 |
| `5`  | `SUCCESS`                                | The order was processed successfully.                                                                                                                                                                                                                                         |
| `6`  | `SEND_NOW`                               | A future order already exists for this subscription before the placement process runs.                                                                                                                                                                                        |
| `9`  | `PENDING_BATCH_RESPONSE`                 | Ordergroove has sent the order and is awaiting a response file. Applies only to merchants on legacy file-based batch placement, not to API-based placement.                                                                                                                   |
| `10` | `PENDING_VERIFICATION`                   | Awaiting confirmation from the merchant or ecommerce platform that the order was processed.                                                                                                                                                                                   |
| `11` | `PENDING_PLACEMENT`                      | The order is queued and will be processed shortly.                                                                                                                                                                                                                            |
| `12` | `EXCEPTION_DURING_PLACEMENT_PREPARATION` | Something failed before the order could be attempted.                                                                                                                                                                                                                         |
| `13` | `CONNECTION_ERROR_DURING_PLACEMENT`      | The connection failed mid-placement, so the outcome is unconfirmed. Depending on your configuration the order may be retried on the next placement, with no retry limit.                                                                                                      |
| `14` | `RESPONSE_PROCESSING_ERROR`              | The merchant's batch or HTTP response wasn't understood. This order isn't retried.                                                                                                                                                                                            |
| `15` | `GENERIC_ERROR_RESPONSE`                 | A generic error was returned or defaulted. You control how many times these are retried.                                                                                                                                                                                      |
| `17` | `MERGED`                                 | The order was merged into another. The target order ID is in the order's extra data, under `merged_order_id`.                                                                                                                                                                 |
| `18` | `CREDIT_CARD_RETRY`                      | The order failed with a `140` error code and is in the credit card retry process.                                                                                                                                                                                             |
| `19` | `AWAITING_RETRY_INSTRUCTIONS`            | The rejection has been classified and `rejected_error_code` now holds the three-character Ordergroove code. This state resolves quickly.                                                                                                                                      |
| `20` | `AWAITING_RESPONSE_CLASSIFICATION`       | The order was rejected and is awaiting classification. While in this state `rejected_error_code` may hold a raw platform code such as `PAYMENT_METHOD_DECLINED` rather than an Ordergroove code — treat it as null until classification completes, typically within a minute. |