Testing
Use the staging environment to develop and test your integration.
We have a staging environment (hosted at api.staging.delivereasy.co.nz) that you can use for development and testing of your integration. Use the staging base URLs when making API calls:
| API | Staging base URL |
|---|---|
| Lastmile | https://api.staging.delivereasy.co.nz/api/2025-04-01/lastmile |
| Marketplace (2026-01-01) | https://api.staging.delivereasy.co.nz/api/2026-01-01/marketplace |
| Marketplace (2025-01-01) | https://api.staging.delivereasy.co.nz/api/2025-01-01/mobipos |
Automated booking progression
Bookings placed in staging automatically progress through the delivery lifecycle, with about a minute between each status change. This lets you test your webhook integration without waiting for a real driver.
The following statuses are covered by the automated progression:
- not_assigned
Booking created, waiting for driver assignment.
- assigned
A driver has been assigned to the booking.
- pickup_enroute
Driver is on their way to the pickup location.
- pickup_nearby
Driver is near the pickup location.
- pickup_arriving
Driver is approaching the pickup location.
- pickup_arrived
Driver has arrived at the pickup location.
- pickup_complete
Driver has collected the parcel.
- dropoff_enroute
Driver is on their way to the dropoff location.
- dropoff_arrived
Driver has arrived at the dropoff location.
- dropoff_complete
Delivery is complete.
Testing webhooks
If you have webhook URLs configured for staging, you will receive a webhook at each status transition during the automated progression. This is the best way to verify that your webhook handler processes all the statuses correctly.