Doorstep API

Programmatic access to delivery analytics and geospatial map data: volumes, timing metrics, heatmaps, and building and address details.

QuickstartMake your first request →Pull total delivery volume for an address in a single authenticated call.

Base URL

https://api.core.doorstep.ai

Getting Started

1. Get an API key. Reach out to your Doorstep account team to have a key issued for your organization.
2. Authenticate. Send the key as a Bearer token on every request:

   Authorization: Bearer <YOUR_TOKEN>

3. Make a request. Call an endpoint and read the JSON response:

   curl "https://api.core.doorstep.ai/v1/analytics/volume?address=550 W 54th St, New York, NY, 10019" \
     -H "Authorization: Bearer $API_KEY"

What You Can Do

VolumeTotal delivery counts for an address.Delivery TimeTiming metrics for a building, such as handover and walking time.Building AnalyticsBuilding-level reference data and delivery metrics.AddressesBuilding polygons, entrances, parking zones, and elevation access points.

---

Reference

Timestamps

All from / to parameters and response timestamps use epoch seconds (Unix time, not milliseconds).

Comma-Separated Filters

Parameters that accept multiple values are passed as comma-separated strings:

deliveryType=doorstep,threshold

Delivery Types

Value	Description
doorstep	Delivered to the door
threshold	Left at the building entrance
curbside	Curbside delivery
vehicle_handoff	Handed off at the vehicle

timeFrame Values

Value	Covers
day	Last 24 hours
week	Last 7 days
month	Last 30 days
3m	Last 3 months
ytd	Year to date
year	Last 365 days
all	All time

from / to (epoch seconds) override timeFrame when provided.

Time Metrics

Returned by the Delivery Time and Building Analytics endpoints. All values are in seconds.

Metric	Description
handoverTime	Time from geofence entry to drop-off
totalTime	Time from geofence entry to geofence exit
activeTime	Time from parking to drop-off
walkingTime	Time from parking to car return
inBuildingTime	Time spent inside the building

Need Help?

Need help? Reach out to your Doorstep account team for access, questions, or integration support.