Order Shipment Status Update

Notifies the order service of a shipment status change using a shipment payload.

At minimum, references.partner_order_reference must match an existing order. When post_shipping_info.status is delivered (and the order is eligible), Carriyo may run auto-close logic on related fulfillment line items. Shopify-sourced orders are skipped for auto-close.

For the complete shipment JSON model, see the Shipping API (shipment object). This endpoint accepts the same structure you receive from shipment webhooks or get-shipment responses.

SecurityOAuth2-Production or OAuth2-Demo
Request
header Parameters
x-api-key
required
string

Your Carriyo API key for authentication.

tenant-id
required
string

Your unique tenant identifier in Carriyo.

Content-Type
string
Default: application/json
Request Body schema: application/json
required
object
object

Latest booking / tracking status on the shipment.

Responses
200

Updated order when processing applied; may return the unchanged order when the shipment does not qualify for updates (for example status is not delivered). The response body may be empty when no order is found for references.partner_order_reference.

400

Invalid request.

post/orders/shipment-status-update
Request samples
application/json
{
  • "references": {
    },
  • "post_shipping_info": {
    }
}
Response samples
application/json
{
  • "tenant": "string",
  • "order_id": "string",
  • "merchant": "string",
  • "partner_order_reference": "string",
  • "language": "string",
  • "order_date": "2019-08-24T14:15:22Z",
  • "sales_channel": "string",
  • "creation_source": {
    },
  • "update_source": {
    },
  • "carriyo_metadata": [
    ],
  • "status": "open",
  • "auto_allocation_failed": true,
  • "cancellation_reason": "CUSTOMER_CANCELLATION",
  • "billing_address": {
    },
  • "customer": {
    },
  • "customer_key": "string",
  • "payment": {
    },
  • "redacted": true,
  • "taxes_included": true,
  • "duties_included": true,
  • "discount_applications": [
    ],
  • "line_items": [
    ],
  • "fulfillment_orders": [
    ],
  • "shipping_lines": [
    ],
  • "error_details": [
    ],
  • "creation_date": "2019-08-24T14:15:22Z",
  • "update_date": "2019-08-24T14:15:22Z"
}