Shipment Details

Shipment Details - Retrieve shipment details and tracking history

Use this endpoint to retrieve full shipment details using a Flype trackingNumber.

The response includes shipment information, recipient details, pickup/merchant information, driver information when available, delivery settings, and shipment status history.

When to use this endpoint

To show detailed shipment information in your system.
To retrieve the full tracking history for a shipment.
To troubleshoot shipment issues or failed delivery attempts.

Important notes

Use trackingNumber returned from Create Bulk Orders.
Some fields may be null if the shipment has not reached that stage yet.
Drop-off details are returned only after successful delivery.

Notes

deliverySettings is returned for all statuses (it will be null if none exist).

dropOffDetails is returned only when the shipment status is delivered (otherwise it will be null).

driver can be null if no driver is assigned.

Bearer Token

Provide your bearer token in the

Authorization

header when making requests to protected resources.

Example:

Authorization: Bearer ********************

Responses

🟢200

application/json

Shipment details.

Bodyapplication/json

Examples

Delivered orderOrder out for deliveryShipment Not Found

{
    "status": "success",
    "data": {
        "trackingNumber": "TKTN0M4DVCJ8",
        "recipient": {
            "name": "Malcolm Metz",
            "email": "Janick.Padberg@hotmail.com",
            "mobileNumber": "13026021804",
            "address": {
                "postalCode": "16401",
                "city": "Virginia",
                "street1": "48875 Virginia Rapid",
                "street2": "379 Gia Gardens",
                "streetNumber": "379",
                "latitude": 6.372,
                "longitude": 150.5645,
                "rdi": 0
            }
        },
        "retailer": {
            "name": "Mary Pouros-Koss",
            "externalLocationId": "LOC123456",
            "address": {
                "postalCode": "90385-3513",
                "city": "Jersey City",
                "street1": "6384 Sheridan Path",
                "street2": "411 N Park Street",
                "streetNumber": "71",
                "latitude": 82.9294,
                "longitude": 118.2611
            }
        },
        "driver": {
            "idNumber": "Mar1435YHF",
            "name": "Mario Costa"
        },
        "statusHistory": [
            {
                "statusUpdatedAt": "2026-01-12T11:44:42:000Z",
                "status": "booked"
            },
            {
                "statusUpdatedAt": "2026-01-12T12:10:04:000Z",
                "status": "at_dc"
            },
            {
                "statusUpdatedAt": "2026-01-12T12:18:15:000Z",
                "status": "to_delivery"
            },
            {
                "statusUpdatedAt": "2026-01-12T15:22:40:000Z",
                "status": "delivered"
            }
        ],
        "deliverySettings": {
            "leave_outside": true,
            "place_type": "apartment",
            "floor": 3,
            "notify_by": "bell",
            "obs": "leave at front door"
        },
        "dropOffDetails": {
            "method": "Left at recipient door",
            "deliveryPhotoURL": "<LINK>"
        }
    }
}

🟠401

🔴500