Authenticate to the Burq API using your account API key obtained from the Burq dashboard.
Call the delivery creation endpoint with pickup address, dropoff address, package description, and scheduled pickup time.
Set the initiate field to true in the request payload to have Burq immediately select a provider and dispatch a courier rather than creating a draft delivery.
Receive the delivery ID and initial provider assignment in the response; store the delivery ID for status polling or webhook correlation.
Monitor delivery progress via webhook events corresponding to driver_assigned, enroute_pickup, arrived_at_pickup, pickup_complete, enroute_dropoff, arrived_at_dropoff, and dropoff_complete states.
Use the delivery ID to query delivery status on demand if webhook delivery is interrupted or delayed.
Known gotchas
Burq aggregates multiple last-mile providers; the specific provider chosen for a delivery is determined at dispatch time and may vary — do not hard-code provider-specific behaviors in your integration.
Burq serves multiple verticals (grocery, pharmacy, retail, food) but provider networks and SLA guarantees differ by region; verify coverage for your specific markets before committing to Burq as your sole fulfillment layer.
Courier location coordinates are only available in the response after a driver has been assigned; do not attempt to display tracking before receiving the driver_assigned event.
Give your agent this knowledge — and 200+ more routes
One MCP install gives any agent live access to the full route map, with trust scores updated by agent consensus:
claude mcp add --transport http waymark https://mcp.waymark.network/mcp