[lightMode]

Shipment Tracking

GET/shipments/{shipment_id}/tracking

[updatedIn] 2 months ago

This endpoint allows you to fetch tracking details for a specific shipment by passing the shipment_id as a path parameter.

`shipping.read`- Shipping Read Only `shipping.read_write`- Shipping Read & Write

Request

Authorization: OAuth 2.0

Add the parameter

Authorization

to [header]，whose value is to concatenate the Token after the Bearer.

[api.label.example]

Authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJzdWIiOiIxMjM0NTY3ODkwIiwibmFtZSI6IkpvaG4gRG9lIiwiaWF0IjoxNTE2MjM5MDIyfQ.SflKxwRJSMeKKF2QT4fwpMeJf36POk6yJV_adQssw5c

[message.pathParameter]

shipment_id

integer

required

Shipment ID

Request samples

[api.label.responses]

Success(200)

HTTP Code: 200

Content Type : JSONapplication/json

status

number

optional

Response status code, a numeric or alphanumeric identifier used to convey the outcome or status of a request, operation, or transaction in various systems and applications, typically indicating whether the action was successful, encountered an error, or resulted in a specific condition.

success

boolean

optional

Response flag, boolean indicator used to signal a particular condition or state in the response of a system or application, often representing the presence or absence of certain conditions or outcomes.

data

object (ShipmentTracking)

optional

number

required

A unique identifier for the shipment. List of shipments can be found here.

order_id

number

required

A unique identifier for the order associated with the shipment. List of orders can be found here

order_reference_id

number | null

required

A uniques identifier associated with an order refrence.

type

string

required

Shipment Type

courier_id

integer

required

Shipment Courier ID. Find a complete list of Shipment companies here

courier_name

string

required

Shipment Courier Name

courier_logo

string

required

Shipment Courier Logo

shipping_number

string

required

Shipping Number

tracking_number

string

required

Tracking Number

pickup_id

number | null

required

A unique identifier associated with a pickup.

trackable

boolean

required

Whether or not the shipment is trackable

tracking_link

string

required

A hyperlink that provides a direct link to the tracking page for the shipment

label

object

required

status

string

required

The current status of the shipment

history

array [object {3}]

required

{
  "status": 200,
  "success": true,
  "data": {
    "id": 362985662,
    "order_id": 560695738,
    "order_reference_id": 48927,
    "type": "shipment",
    "courier_id": 1927161457,
    "courier_name": "Shipping App",
    "courier_logo": "https://salla-dev-portal.s3.eu-central-1.amazonaws.com/uploads/Zo3PtoY2KNo3MkpWARHXhK91DUrsEtQJJqpz5PbY.png",
    "shipping_number": "846984645",
    "tracking_number": "43534254",
    "pickup_id": null,
    "trackable": true,
    "tracking_link": "https://api.shipengine.com/v1/labels/498498496/track",
    "label": {
      "format": "pdf",
      "url": "https://salla-dev.s3.eu-central-1.amazonaws.com/mKZa/shipping-policy/48102-IPqC9O6ysElWi4ze5148I2ilFABxAKvHggmEG4pB.pdf"
    },
    "status": "delivering",
    "history": [
      {
        "status": "delivering",
        "note": "third note the shipment is on the way",
        "create_at": {
          "date": "2023-04-06 11:57:51.000000",
          "timezone_type": 3,
          "timezone": "Asia/Riyadh"
        }
      },
      {
        "status": "created",
        "note": "second note without sending the status in the request",
        "create_at": {
          "date": "2023-04-06 11:49:51.000000",
          "timezone_type": 3,
          "timezone": "Asia/Riyadh"
        }
      },
      {
        "status": "created",
        "note": "first note without sending the status in the request",
        "create_at": {
          "date": "2023-04-06 11:49:35.000000",
          "timezone_type": 3,
          "timezone": "Asia/Riyadh"
        }
      },
      {
        "status": "created",
        "note": null,
        "create_at": {
          "date": "2023-04-06 11:44:23.000000",
          "timezone_type": 3,
          "timezone": "Asia/Riyadh"
        }
      }
    ]
  }
}

[updatedIn] 2 months ago