Check Order Status

This page details the technical specification for checking the status of an order to the Clothes2order API. Once an order is placed, you can query our system to retrieve information about the current order status.

Fetch Order API Endpoint

The API endpoint for checking the status of an order is:

https://www.clothes2order.com/api/fetch-order/

 

Post XML Fields

 

Node Description
api_key Your API key.
order->your_order_id The order id you wish you query. Either this or ‘c2o_order_id’ should be specified.
order->c2o_order_id The Clothes2order order id you wish to query. Either this or ‘your_order_id’ should be specified.

 

Response XML Fields

The API will respond with XML once a fetch request is submitted; please see below for details.

 

Node Description
status->code Either ‘OK’ or ‘ERROR’. If a fatal error is reported here, the request will not be processed. You can also check the HTTP response code header; ‘OK’ returns 200, ‘ERROR’ returns 400.
status->msg The associated success or error message.
order_details->c2o_order_id The Clothes2order order number for the placed order.
order_details->your_order_id Your order number passed when the order was placed.
order_details->net_order_value The net cost you have been charged for the order.
order_details->gross_order_value The gross cost you have been charged for the order.
order_details->est_dispatch_date The estimated dispatch date for your order.
order_details->order_status The current status of the order. Typical values include ‘Processing Order’, ‘Dispatched’ and ‘On Hold’.
order_details->shipped_by The delivery method used to send the order (node included if the current status is ‘Dispatched’) .
order_details->tracking_link The direct courier tracking link for the order (node included if the current status is ‘Dispatched’).
progress_images->progress_image A list of images that have been taken of the order in progress, if any are available. For more information about this unique feature, please click here
order_issues->issue->reason In the rare cases there are any outstanding issues with your order, these will be shown here. By clicking an order number in your online order history you can then view full details of the issue.
order_issues->issue->date_added The date the above outstanding order issue was recorded.

Important Notes

Checking the status of orders is not currently rate limited, but is subject to reasonable fair use limits. The status of an order is unlikely to change more than once a day. Orders are dispatched by 8pm BST Monday to Friday, so we would recommend checking the status of an order after this time and caching the results for 24 hours. Once an order reaches the ‘Dispatched’ status, the status will not change from this point so should not be queried again.