Developer Portal

OTDS REST API

Automate your shipping workflows. Integrate our logistics capabilities directly into your e-commerce platform, WMS, or ERP system to create shipments and track parcels in real-time.

Request API Key

Authentication

All API requests must be authenticated using a Bearer token in the Authorization header. You can obtain your API key by contacting our integration support team.

Authorization: Bearer YOUR_API_KEY

Environments

We provide a Sandbox environment for testing your integrations before going live.

  • Sandbox: https://sandbox-api.otdscourier.com/v1
  • Production: https://api.otdscourier.com/v1
POST

Create Shipment

Registers a new shipment in the OTDS network. Returns a unique tracking number and printable waybill URL.

Request Body

{
  "reference_id": "ORD-10293",
  "service_type": "express",
  "origin": {
    "name": "Warehouse A",
    "phone": "+919876543210",
    "address": "123 Ind Estate",
    "city": "Guwahati",
    "pincode": "781001"
  },
  "destination": {
    "name": "Customer Name",
    "phone": "+919998887776",
    "address": "456 Main St",
    "city": "Shillong",
    "pincode": "793001"
  },
  "packages": [
    {
      "weight_kg": 2.5,
      "dimensions_cm": "20x20x15"
    }
  ]
}

Response (201 Created)

{
  "status": "success",
  "data": {
    "tracking_number": "OTDS-102938475",
    "waybill_url": "https://api.otdscourier.com/docs/wb-102938475.pdf",
    "estimated_delivery": "2024-12-05",
    "service": "Express Delivery"
  }
}
GET

Track Shipment

Retrieve the latest status and full scanning history for a specific tracking number.

/shipments/{tracking_number}/track

Response (200 OK)

{
  "status": "success",
  "data": {
    "tracking_number": "OTDS-102938475",
    "current_status": "In Transit",
    "estimated_delivery": "2024-12-05",
    "events": [
      {
        "timestamp": "2024-12-04T10:30:00Z",
        "status": "Departed Facility",
        "location": "Guwahati Hub"
      },
      {
        "timestamp": "2024-12-04T08:15:00Z",
        "status": "Shipment Picked Up",
        "location": "Origin Warehouse"
      }
    ]
  }
}