Skip to main content
GET
/
tracking
/
package
cURL
curl --request GET \
  --url https://dev.api.r4technology.io/tracking/package \
  --header 'Authorization: Basic <encoded-value>'
{
  "package_id": "550e8400e29b41d4a716446655440000_02-010005",
  "return_order_id": "550e8400-e29b-41d4-a716-446655440000",
  "current_status": "hub dropoff",
  "tracking_updates": [
    {
      "status": "detail",
      "timestamp": "2025-03-15T14:23:17Z",
      "description": "Package scanned and received at a dropoff point"
    },
    {
      "status": "hub dropoff",
      "timestamp": "2025-03-16T09:12:48Z",
      "description": "Package arrived at consolidation hub"
    }
  ],
  "total_updates": 2,
  "items": [
    {
      "id": "abc123",
      "sku": "SHIRT-BLU-LG",
      "title": "Blue Shirt",
      "description": "Classic blue button-down shirt",
      "variant_description": "Large",
      "quantity": 1,
      "image": "https://example.com/shirt.jpg"
    }
  ]
}

Authorizations

Authorization
string
header
required

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

Query Parameters

package_id
string
required

The encoded package ID combining return_order_id and spot_order_key

Example:

"550e8400e29b41d4a716446655440000_02-010005"

Response

Tracking information for the package

package_id
string

The encoded package ID that was looked up

return_order_id
string

The decoded return order UUID

current_status
string

The most recent tracking status for this package

tracking_updates
object[]

Array of tracking updates in chronological order

total_updates
integer

Total number of tracking updates

items
object[]

Array of items in this package