Skip to main content
cURL
curl --request POST \
  --url https://dev.api.r4technology.io/endpoint/tracking-webhook \
  --header 'Authorization: Basic <encoded-value>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "return_order_id": "ZG12345678",
  "store_id": "hou-store-042",
  "status": "detail",
  "timestamp": "2025-03-15T14:23:17Z",
  "description": "Package scanned and received at a dropoff point",
  "packages": [
    {
      "package_id": "01044ed53ce747ec8c115009233f759d_02-010012",
      "items": [
        {
          "id": "050f5297-e022-4903-ac21-0e1c36f63850",
          "sku": "SHIRT-BLU-LG",
          "title": "Blue Shirt",
          "description": "Classic blue button-down shirt",
          "variant_description": "Large",
          "quantity": 1,
          "image": "https://example.com/shirt.jpg"
        }
      ]
    }
  ]
}
'
This is a webhook that we send to your endpoint. You cannot call this endpoint.

Authorizations

​
Authorization
string
header
required

Basic authentication header of the form Basic <encoded-value>, where <encoded-value> is the base64-encoded string username:password.

Body

application/json

Tracking update notification

​
return_order_id
string

The return order ID for this tracking update

​
store_id
string

The external ID of the store where the package was dropped off

​
status
string

The new status of the order

​
timestamp
string<date-time>

ISO 8601 timestamp of the status update

​
description
string

Human-readable description of the status

​
packages
object[]

Packages belonging to this order that have been assigned a package ID. Items not yet assigned to a package are excluded.