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

# 📦 Get Order by ID

Use this endpoint to retrieve the full details of an order using your `integrationOrderId`.

***

#### 🔗 Endpoint

```
GET /custom-integration/orders/{integrationOrderId}
```

**Example:**

```
https://api.drop-hub.com/api/custom-integration/orders/ABC123XYZ
```

***

#### ✅ Example Response

```json
{
  "integrationOrderId": "ORD-20250721-0004",
  "orderStatus": "PICKED_UP",
  "driverName": "Mohammed Al-Qahtani",
  "driverPhoneNumber": "+966500001111",
  "driverRating": 4.9,
  "deliveryFee": 22.0,
  "distanceInKM": 9.5,
  "estimatedDeliveryTimeMinutes": 24,
  "storeName": "Pizza House",
  "orderDate": "2025-07-21T10:25:00Z",
  "paymentMethod": "CASH",
}
```

***

#### ❌ Error Response (Not Found)

```json
{
  "status": "error",
  "statusCode": 404,
  "message": "Order not found",
  "timestamp": 1753092658001
}
```
