Restricted Items

Flagging Restricted Items.

In case your delivery contains age restricted items such as alcohol, tobacco, fireworks & more, you will need to provide this information when creating a job in our API. This will trigger an additional validation step during the delivery.

It is important to note that in such scenarios, our couriers have been trained and will be asked to follow a specific ID checking process in order to validate the delivery at the dropoff.

If the customer fails age verification, we would return the items back to the origin address. When the return is triggered you can expect to receive a ‘cancelled’ delivery status with the API response "cancellation.reason_key":"end-customer_underage". The order will then continue on to a 'delivered' status to confirm the return to store. You can find more details on tracking returns and our cancellation reasons in our API documentation.

Delivery Options - Restricted Items (UK ONLY)

When creating a job using our job creation endpoint, you can use the 'delivery_options' object that contains the 'restricted_items' field to add in any items that require age verification. By using this API array, you will be able to specify the reason age-verification is required with increased granularity.

Please note that this feature is currently only available for the UK. Using this field when operating outside of the UK will flag an error, hence we suggest if you operate in countries outside of the UK to use the original Challenge 25 format for those countries.

An example of this field is shown below:

{
    "job": {
        "pickups": [
          ...
        ],
        "dropoffs": [
            {
              ... ,
              "delivery_options": {
                  "restricted_items": ["ALCOHOL", "TOBACCO"]
              }
         ]
    }
}

The different values you are able to use for this field are one or more of:
“TOBACCO”, “LOTTERY”, “KNIVES”, “FIREWORKS”, “SOLVENTS”, “BUTANE”, “ALCOHOL”, “SUNBEDS”

This will display this list of restricted items included in the order directly in the driver invitation screen before accepting it, please see screenshots of the process below:

Please note, for the 'Alcohol' restricted item we included an additional step to ensure sobriety of the customer. Please see addtional screen shots below.

Challenge 25 Flag Option (all countries)

  • add the 🔞 emojis in the job.dropoff.package_desctiption field of the job creation request with the text "challenge 25" inside, ie. (“🔞 Challenge 25 🔞”). Please note, addtional text can be inserted within the emojis informing the courier of the type of item for example alcohol or tobacco.
  • Make sure that the payload has the emoji well copied and not converted to text :underage. You can copy and paste the emojis from here for ease.

Following the above steps will notify the courier that the delivery job is a “18+ delivery” directly in the courier invitation screen before accepting it. While not being able to granularly inform the courier which items the +18 delivery contains, we highly encourage adding this infomation to description field as mentioned above to avoid any issues once the courier arrives at the pickup location.