> 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/api/generate-dummy-drivers.md).

# 🧪 Generate Dummy Drivers

Use this endpoint to generate dummy (virtual) delivery drivers around a specific location. The system will automatically distribute the drivers **within a 10 km radius** from the given coordinates. This is useful for testing dispatch logic and simulating delivery flow in sandbox environments.

***

#### 🔗 Endpoint

```
POST /custom-integration/generate-dummy-drivers
```

**Full URL (Sandbox Only):**

```
https://api.drop-hub.com/api/custom-integration/generate-dummy-drivers
```

***

#### 🔐 Authentication Required

Include your API key in the header:

```
x-api-key: your-api-key
```

***

#### 📥 Request Body

```json
{
  "latitude": 24.7136,
  "longitude": 46.6753
}
```

| Field       | Type   | Description                      | Required |
| ----------- | ------ | -------------------------------- | -------- |
| `latitude`  | double | Latitude of the target location  | ✅        |
| `longitude` | double | Longitude of the target location | ✅        |

***

#### ✅ Example Request (cURL)

```bash
curl -X POST 'https://api.drop-hub.com/api/custom-integration/generate-dummy-drivers' \
--header 'Content-Type: application/json' \
--header 'x-api-key: YOUR_API_KEY' \
--data-raw '{
  "latitude": 24.7136,
  "longitude": 46.6753
}'
```

***

#### 📤 Success Response

```json
{
  "data": "",
  "status": "success",
  "statusCode": 200,
  "timestamp": 1726132658387,
  "message": "تمت العملية بنجاح"
}
```

***

#### ⚠️ Notes

* Available only in **sandbox** environments.
* Drivers generated are **mock/test data** used for simulating delivery flow.
* This endpoint does not affect live orders or production systems.