Developer API Integration

RYDR’s RESTful API lets you programmatically book and track deliveries. Authenticate with your API key, then use our endpoints to create orders, check status, and manage your shipments.

1. Authentication

All requests must include your API key in the `Authorization` header:

Authorization: Bearer YOUR_API_KEY

2. Endpoints

Create Order
POST /api/v1/orders
Body: JSON with pickup, drop, weight, value, payment_type
Get Order Status
GET /api/v1/orders/{order_id}
Cancel Order
DELETE /api/v1/orders/{order_id}

3. Sample cURL Request

curl -X POST https://api.rydr.space/api/v1/orders \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "pickup": "MG Road, Mumbai",
    "pickup_phone": "+919876543210",
    "drop": "Bandra West, Mumbai",
    "drop_phone": "+919812345678",
    "weight": 2.5,
    "parcel_value": 500,
    "payment_type": "Cash"
  }'

4. Sample JavaScript (fetch)

fetch('https://api.rydr.space/api/v1/orders', {
  method: 'POST',
  headers: {
    'Authorization': 'Bearer YOUR_API_KEY',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    pickup: 'MG Road, Mumbai',
    drop: 'Bandra West, Mumbai',
    weight: 2.5,
    parcel_value: 500,
    payment_type: 'Cash'
  })
})
  .then(res => res.json())
  .then(data => console.log('Order created:', data))
  .catch(err => console.error(err));

5. Support & Limits

Rate limit: 100 requests per minute.
For higher throughput or custom integrations, contact sales at api-support@rydr.space.