Assign driver

With this endpoint, you can assign a driver or vehicle to a delivery.

Assign a driver to a delivery or route.

Assign a driver to a delivery or route.

post

/v1/routes/{id}/assign

Authorizations

Path parameters

idstringrequired

Identifier or reference Id of the delivery or route to which a driver will be assigned

Body

courierIdintegerrequired

Driver identifier to whom the delivery/route will be assigned. No other property is sent in the payload

Example: 1234

vehicleIdinteger

Driver's vehicle identifier to which the delivery/route will be assigned. No other property is sent in the payload

Example: 2344

vehicleReferenceIdstring

Driver's vehicle reference to which the delivery/route will be assigned. No other property is sent in the payload

Example: 2344

driverobject

Driver's information. Only sent if it's necessary to create the driver within the system.

vehicleobject

Driver's vehicle information. Only sent if it's necessary to create the driver within the system.

Responses

application/json

application/json

cURL

JavaScript

Python

HTTP

cURL

curl -L \
  --request POST \
  --url 'https://api.shippify.co/v1/routes/{id}/assign' \
  --header 'Authorization: Basic username:password' \
  --header 'Content-Type: application/json' \
  --data '{
    "courierId": 1234,
    "vehicleId": 2344,
    "vehicleReferenceId": 2344,
    "driver": {
      "firstName": "LUIS ALBERTO",
      "lastName": "PILALUISA CONDOR",
      "dni": "1721547592",
      "mobile": "0990670384"
    },
    "vehicle": {
      "capacity": 1,
      "model": "Civic",
      "brand": "Honda",
      "licensePlate": "TAA6662",
      "referenceId": "UE1118"
    }
  }'

200

401

200

{
  "code": "OK"
}

Successful operation

Casos de uso

Assign driver to delivery ID

{
    "courierId": 396930
}

Assign driver to delivery reference ID

You can use the delivery reference ID in the URL of the request to assign a driver.

Assign driver by vehicle ID

{
    "vehicleId": 19365
}

Assign driver by vehicle reference ID

{
    "vehicleReferenceId": 19365
}

Create and assign a vehicle and driver to a task

{
    "driver": {
        "firstName": "LUIS ALBERTO",
        "lastName": "PILALUISA CONDOR",
        "dni": "1721547592",
        "mobile": "0990670384"
    },
    "vehicle": {
        "capacity": 1,
        "model": "Truck",
        "brand": "SINOTRUCK",
        "licensePlate": "TAA6662",
        "referenceId": "UE1118"
    }
}