Get Task Details By Reference I.D.

EndPoint

GET /v1/tasks/task-details
X-API-Key: your-api-key-goes-here
Content-Type: application/json

Body

{
    "ref_id": "3656*************"
}

Response

{
    "success": true,
    "count": 2,
    "data": [
        {
            "_id": "33f45*********",
            "recipient_phone": "+1000000000",
            "recipient_name": "John Doe",
            "recipient_email": "[email protected]",
            "driver_note": null,
            "task_type": "delivery",
            "destination_address": "****, **th St San Francisco, CA, 94**, USA",
            "destination_address_latlng": {
                "lat": 0.0000,
                "lng": 0.000
            },
            "destination_address_2": "725",
            "task_status": 3,
            "delivery_date": "2025-06-18",
            "file_url": [
                "<some-url->"
            ],
            "handed_to_customer": false,
            "owner": {
                "_id": "673f391*****"
            },
            "tags": [],
            "ref_id": "680a607abec********",
            "created_at": "2025-04-20T23:50:28-07:00",
            "updated_at": "2025-05-05T00:32:53Z",
            "__v": 0,
            "distance_matrix": {
                "distance": {
                    "text": "3.0 km",
                    "value": 3011
                },
                "duration": {
                    "text": "8 mins",
                    "value": 476
                },
                "raw_eta": 1746406616443,
                "eta_time": "05/04/2025 05:56 PM",
                "index": 1,
                "start_time": "05/04/2025 05:41 PM",
                "task_id": "380f45e1*******",
                "ref_id": "380a607a*******"
            },
            "driver": {
                "_id": "534******444",
                "name": "John Doe",
                "driver_image": "",
                "phone": "+10000000000",
                "address": "San Francisco, CA",
                "address_latlng": {
                    "lat": "0.00",
                    "lng": "0.00"
                },
                "email": "[email protected]",
                "vehicle_type": "car",
                "vehicle_model": "Chevy",
                "vehicle_capacity": "25",
                "vehicle_capacity_type": "number",
                "vehicle_license_plate": "",
                "vehicle_color": "gray",
                "online_status": true,
                "current_location": {
                    "lat": 0.0,
                    "lng": 0.0
                },
                "last_active": "2025-05-01T23:15:49Z",
                "cost_per_hour": "18.00",
                "cost_per_km": "0.38"
            },
            "sort_number": 38,
            "completion_note": null,
            "eta": null,
            "hub": null,
            "manualLatLngMode": false,
            "signature_img": null,
            "origin_address_latlng": {
                "lat": 0,
                "lng": 0
            },
            "start_address_latlng": {
                "lat": 0,
                "lng": 0
            },
            "start_time": "2025-05-04T17:21:13-07:00",
            "completed_time": "2025-05-04T17:32:42-07:00",
            "complete_address_latlng": {
                "lat": 0,
                "lng": 0
            },
            "tracking_link": "https://dashboard.operationtrack.com/drivers/position/*******/*******",
            "current_location": {
                "lat": 0,
                "lng": 0
            },
            "location_path": [
                {
                    "lat": 0,
                    "lng": 0
                }
            ]
        },
       // .. other tasks
    ],
    "msg": "Success"
}

Error Responses

Error - Not Found

Status Code: 200

{
    "success": true,
    "count": 0,
    "data": [],
    "msg": "Success"
}