In the coming weeks, we are introducing an enhancement to the GET /orders API. While we expect minimal to no impact, we wanted to notify you of this upcoming change so that you have time to review your integrations for any possible impact.
What's Changing?
Currently, the GET /orders method returns a single Order record for a given Original Order ID. This new upgrade eliminates the shortcoming in cases where there are multiple Order records, all having the same Original Order ID. Such a case is when the integration with an eCommerce platform posts status updates for the same order.
How Will It Work?
Instead of returning a single record for the Original Order ID, GET /orders will now return an array of Order records, all for the same Original Order ID. Even if there is only one Order record, it will still be returned within an array.
Sample Code:
GET /orders/1008.json returns the following example payload:
[
{
"id": 30035,
"account_id": 1400,
...
"order_status": "paid",
"original_order_id": "1008",
...
},
{
"id": 30197,
"account_id": 1400,
...
"order_status": "shipped",
"original_order_id": "1008",
...
},
{
"id": 30249,
"account_id": 1400,
...
"order_status": "received",
"original_order_id": "1008",
...
}
]
If you have any questions, please reach out to support@maropost.com.