> For the complete documentation index, see [llms.txt](https://routelift.gitbook.io/routelift-api-integration/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://routelift.gitbook.io/routelift-api-integration/api-reference/get-history.md).

# Get History

Retrieves a paginated list of delivery history.

**Endpoint:** `GET /v1/deliveries/history`

Base URL

* Test: `https://sandbox-integrations.routelift.com/v1/deliveries/history`
* Live: `https://integrations.routelift.com/v1/deliveries/history`

| Parameter | Type   | Required | Description                                                                                |
| --------- | ------ | -------- | ------------------------------------------------------------------------------------------ |
| page      | number | No       | Page number for pagination (default: 1)                                                    |
| limit     | number | No       | Number of items per page (default: 10)                                                     |
| status    | string | No       | Filter deliveries by status (`pending, assigned`,  `ongoing, delivered, cancelled, failed` |

Sample Response:

```json
{
    "success": true,
    "data": {
        "data": [
            {
                "trackingCode": "A3WMBMHZ",
                "sender": {
                    "address": "12 Allen Avenue, Ikeja",
                    "name": "John Doe",
                    "phone": "08012345678",
                    "note": "Call when outside",
                    "altPhone": "08098765432",
                    "location": {
                        "coordinates": [
                            3.3515,
                            6.6018
                        ],
                        "type": "Point"
                    }
                },
                "receiver": {
                    "address": "45 Admiralty Way, Lekki Phase 1",
                    "name": "Jane Doe",
                    "phone": "08123456789",
                    "note": "Deliver before 5PM",
                    "altPhone": "07011223344",
                    "location": {
                        "coordinates": [
                            3.4813342,
                            6.4478131
                        ],
                        "type": "Point"
                    },
                    "packageSize": "medium",
                    "categories": [
                        "Food and Beverages",
                        "Shoes",
                        "Clothing",
                        "Electronics"
                    ],
                    "photoUrls": null
                },
                "paid": false,
                "status": "pending",
                "createdAt": "2025-06-30T16:58:29.867Z",
                "price": "4000",
                "weight": "5"
            },
            {
                "trackingCode": "BHCN09CV",
                "sender": {
                    "address": "12 Allen Avenue, Ikeja",
                    "name": "John Doe",
                    "phone": "08012345678",
                    "note": "Call when outside",
                    "altPhone": "08098765432",
                    "location": {
                        "coordinates": [
                            3.3515,
                            6.6018
                        ],
                        "type": "Point"
                    }
                },
                "receiver": {
                    "address": "45 Admiralty Way, Lekki Phase 1",
                    "name": "Jane Doe",
                    "phone": "xxxxxxx",
                    "note": "Deliver before 5PM",
                    "altPhone": "xxxxxxxx",
                    "location": {
                        "coordinates": [
                            3.4813342,
                            6.4478131
                        ],
                        "type": "Point"
                    },
                    "packageSize": "medium",
                    "categories": [
                        "Food and Beverages",
                        "Shoes",
                        "Clothing",
                        "Electronics"
                    ],
                    "photoUrls": null
                },
                "paid": false,
                "status": "pending",
                "createdAt": "2025-06-30T16:47:49.507Z",
                "price": "4000",
                "weight": "5"
            },
            {
                "trackingCode": "39W0YSR9",
                "sender": {
                    "address": "12 Allen Avenue, Ikeja",
                    "name": "John Doe",
                    "phone": "xxxxxxxx",
                    "note": "Call when outside",
                    "altPhone": "xxxxxxx",
                    "location": {
                        "coordinates": [
                            3.3515,
                            6.6018
                        ],
                        "type": "Point"
                    }
                },
                "receiver": {
                    "address": "45 Admiralty Way, Lekki Phase 1",
                    "name": "Jane Doe",
                    "phone": "xxxxxxxxx",
                    "note": "Deliver before 5PM",
                    "altPhone": "xxxxxxxxx",
                    "location": {
                        "coordinates": [
                            3.4813342,
                            6.4478131
                        ],
                        "type": "Point"
                    },
                    "packageSize": "medium",
                    "categories": [
                        "Food and Beverages",
                        "Shoes",
                        "Clothing",
                        "Electronics"
                    ],
                    "photoUrls": null
                },
                "paid": false,
                "status": "pending",
                "createdAt": "2025-06-30T16:47:00.756Z",
                "price": "4000",
                "weight": "5"
            }
        ],
        "meta": {
            "page": 1,
            "limit": 30,
            "itemCount": 3,
            "pageCount": 1,
            "hasPreviousPage": false,
            "hasNextPage": false
        }
    },
    "message": "Deliveries history fetched successfully!"
}
```