> For the complete documentation index, see [llms.txt](https://docs.shipbubble.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.shipbubble.com/api-reference/tracking/get-shipments.md).

# Get shipments

Retrieve a list of all shipping labels created on your integration

{% hint style="info" %}
Some couriers require that a waybill document be attached to the package before pickup or collection. In that case, we would include a **waybill\_document** property which contains a downloadable URL for the requested document.
{% endhint %}

<mark style="color:blue;">`GET`</mark> `https://api.shipbubble.com/v1/shipping/labels`

{% tabs %}
{% tab title="200: OK check below for the types of order status codes" %}

```javascript
{
    "status": "success",
    "message": "Retrieved successfully",
    "data": {
        "results": [
            {
                "order_id": "SB-BB7EDE9F",
                "status": "picked_up",
                "courier": {
                    "name": "Kwik",
                    "email": "kwik@kwik.com",
                    "phone": "08029274847",
                    "tracking_code": "12106AF828-2898",
                    "tracking_message": null,
                    "rider_info": null
                },
                "ship_from": {
                    "name": "Lebron James",
                    "phone": "+2348057575855",
                    "email": "lebron@james.com",
                    "address": "Phase 1, 4 Michael Olawale-Cole Dr, Lekki Phase I 106104, Lagos, Nigeria",
                    "latitude": 6.459056599999999,
                    "longitude": 3.4769383
                },
                "package_status": [
                    {
                        "status": "Pending",
                        "datetime": "2022-02-14 22:58:02"
                    }
                ],
                "ship_to": {
                    "name": "Lebron James",
                    "email": "lebron@james.com",
                    "phone": "+2348057575855",
                    "address": "Alh. Masha Rd, Surulere 101241, Lagos, Nigeria",
                    "latitude": 6.499872799999999,
                    "longitude": 3.3609343
                },
                "dropoff_station": null,
                "pickup_station": null,
                "waybill_document": null,
                "events": [],
                "tracking_url": "https://localhost:5000/orders/tracking/GET-BB7EDE9F",
                "date": "2022-01-28T01:17:46.000Z"
            },
            {
                "order_id": "SB-SSS7EDE9F",
                "status": "picked_up",
                "courier": {
                    "name": "DHL",
                    "email": "dhl@dhl.com",
                    "phone": "08029274847",
                    "tracking_code": "12106AF828-2898",
                    "tracking_message": null,
                    "rider_info": null
                },
                "ship_from": {
                    "name": "Lebron James",
                    "phone": "+2348057575855",
                    "email": "lebron@james.com",
                    "address": "Phase 1, 4 Michael Olawale-Cole Dr, Lekki Phase I 106104, Lagos, Nigeria",
                    "latitude": 6.459056599999999,
                    "longitude": 3.4769383
                },
                "ship_to": {
                    "name": "Lebron James",
                    "email": "lebron@james.com",
                    "phone": "+2348057575855",
                    "address": "Alh. Masha Rd, Surulere 101241, Lagos, Nigeria",
                    "latitude": 6.499872799999999,
                    "longitude": 3.3609343
                },
                "package_status": [
                    {
                        "status": "Pending",
                        "datetime": "2022-02-14 22:58:02"
                    }
                ],
                "dropoff_station": null,
                "pickup_station": null,
                "events": [
                    {
	                "location": "IBADAN GATEWAY",
	                "message": "Shipment Departs Collation Center",
	                "captured": "2022-06-10T11:16:20.337"
                    }
                ],
                "waybill_document":"https://storage.googleapis.com/get-web-app-assets/1274529970.pdf",
                "tracking_url": "https://localhost:5000/orders/tracking/GET-BB7EDE9F",
                "date": "2022-01-28T01:17:46.000Z"
            }
        ],
        "pagination": {
            "current": 1,
            "perPage": 1,
            "previous": 0,
            "next": 7,
            "total": 8
        }
    }
}
```

{% endtab %}
{% endtabs %}

### **Shipment status definitions**

{% hint style="warning" %}
**pending**: the shipment request has been processed to the selected courier service
{% endhint %}

{% hint style="info" %}
**confirmed**: the shipment request has been acknowledged and accepted by the courier.
{% endhint %}

{% hint style="info" %}
**picked\_up**: the shipment package has been picked up from the sender's location by the courier.
{% endhint %}

{% hint style="info" %}
**in\_transit**: the shipment package is on its way to the receiver's location.
{% endhint %}

{% hint style="success" %}
**completed**: the shipment package has been delivered to the receiver's location by the courier.
{% endhint %}

{% hint style="danger" %}
**cancelled**: the shipment request has been cancelled
{% endhint %}