Restricted Items

In case your delivery contrains age restricted items (alcool, tobacco...), you can provide this information when creating a job in our API, in order to trigger a specific scenario during the delivery.

It is important to note that in such scenarios, the courier 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 "cancellation.reason_key":"end-customer_underaged". The order will then continue on to a delivered status to signify the return to store. You can find more details on tracking returns and our cancellation reasons in our API documentation.

Granular option (UK only)

When creating a job using our job creation  endpoint, you are able to use the delivery_options object that contains the restricted_items field to add in any items that require age verification. By using this field 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:

This will display the information that this delivery is a 18+ or 16+ delivery directly in the driver invitation screen before accepting it, see screenshots below:


Generic option (all countries)

  • add the :underage: emojis in the job.dropoffs[n].package_description field of the job creation request with some text inside, (ie. “:underage: Challenge 25 :underage:”).
  • 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 .