API Integration

Integration Workflow

A typical end-to-end integration follows these steps, from checkout to delivery.

1. 1

   Check Serviceability

   Validate origin and destination pin codes before checkout to confirm the shipment can be delivered.

2. 2

   Set Up Pickup Locations

   Register your warehouse or store as a pickup point using the Warehouse API.

3. 3

   Create the Shipment

   Push order details through the Order Creation API to generate a waybill for the shipment.

4. 4

   Generate Shipping Labels

   Fetch a print-ready packing slip and shipping label for the order via the Label API.

5. 5

   Schedule a Pickup

   Request a courier pickup for one or more shipments through the Pickup Request API.

6. 6

   Track the Order

   Poll or subscribe to the Tracking API for real-time status updates as the shipment moves.

7. 7

   Cancel if Needed

   Cancel an order before dispatch through the Cancellation API when a customer changes their mind.

Developer Guidelines

curl -X POST https://api.fastdelhivery.com/v1/orders \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "origin_pincode": "110034",
    "destination_pincode": "400001",
    "payment_mode": "prepaid",
    "weight_kg": 1.2
  }'

• Use GET for read-only calls (tracking, serviceability) and POST for actions that create or change data.
• Every POST request must include your API key in the Authorization header — never in the request body or a public URL.
• Keep your API keys on your server only. Never call these endpoints directly from client-side or browser code.
• Test thoroughly in the staging environment before switching your integration over to production.