Slider API

Add on-demand delivery to your website or app. Send orders to Slider's rider network through a simple REST API — your brand, your customer, our delivery.

The Slider API lets any business create deliveries programmatically. When your customer places an order on your platform, send it to Slider and our rider network handles pickup, delivery, and live tracking. Orders appear in your Slider dashboard, and you manage everything through your account wallet.

Authentication

Every request must include your API key in the X-Slider-Key header. You can get your API key from your Slider dashboard under API Credentials → API Keys.

X-Slider-Key:sk_live_your_api_key_here

Create a Delivery

Creates a new delivery order. Slider assigns the nearest available rider and begins pickup. Returns a delivery object with a tracking ID.

Example request

# Create a delivery — rider is assigned instantly
curl -X POST https://api.slider-app.com/v1/deliveries \
  -H "X-Slider-Key: sk_live_your_api_key" \
  -H "Content-Type: application/json" \
  -d '{
    "order_id": "12345678",
    "account_id": "67aad895d28efa2a4aa35263",
    "display_order_id": "SDNN-9970",
    "vehicle_type": "bike",
    "schedule_at": "2026-07-28T16:31:36Z",
    "driver_tip": 0,
    "pickup": {
      "address": "12 Al Feehah St - Mohamed Bin Zayed City - Abu Dhabi",
      "latitude": 25.2048,
      "longitude": 55.2708,
      "directions": "Shop 12, Ground Floor, Marina Mall",
      "contact_number": "+971501234567"
    },
    "dropoff": {
      "address": "Dalma Mall",
      "latitude": 25.1972,
      "longitude": 55.2744,
      "directions": "Villa 7, Street 3, Jumeirah 1",
      "contact_number": "+971507654321"
    },
    "payment_on_delivery": {
      "type": "cash",
      "amount": 120.00
    }
  }'

Example response

{
  "order_number": 61841588,
  "order_id": "12345678",
  "status": "searching_rider",
  "vehicle_type": "bike",
  "fare": 10,
  "currency": "AED",
  "distance_km": 1.67,
  "tracking_url": "https://slider-app.com/t/90fo-hzv6.aPtdkiDcKW89",
  "created_at": "2026-08-03T08:47:12+00:00"
}

Parameters

Top-level fields

Pickup object required

Dropoff object required

Vehicle Selection

The vehicle_type field controls which vehicle handles the delivery. Three options:

Scheduling

By default, deliveries are dispatched immediately. To schedule a delivery for a future time, set the schedule_at field to an ISO 8601 timestamp in UTC. Leave it null (or omit it) for instant dispatch.

// Immediate delivery
"schedule_at": null

// Scheduled for a specific time (ISO 8601, UTC)
"schedule_at": "2026-07-28T16:31:36Z"

Cash / Card on Delivery

If your customer pays on delivery rather than prepaying on your site, use the payment_on_delivery object. The rider collects the amount and it is reconciled to your wallet. Omit this object entirely if the customer has already paid you online.

// Cash on delivery, rider collects AED 120
"payment_on_delivery": {
  "type": "cash",
  "amount": 120.00
}
 
// Card on delivery, rider collects AED 480 via card machine
"payment_on_delivery": {
  "type": "card",
  "amount": 480.00
}
 
// Customer already paid online — omit the object entirely

Response

The API returns a delivery object with status, vehicle assignment, and tracking information.

Success Response (200 OK)

{
  "order_number": 61841588,
  "order_id": "12345684",
  "status": "searching_rider",
  "vehicle_type": "bike",
  "fare": 10,
  "currency": "AED",
  "distance_km": 1.67,
  "tracking_url": "https://slider-app.com/t/90fo-hzv6.aPtdkiDcKW89",
  "created_at": "2026-08-03T08:47:12+00:00"
}

Get Delivery Status

Retrieve the current status, driver location, and delivery details for an order.

Example response

{
  "order_number": 20969271,
  "order_id": "12345685",
  "status": "in_transit",
  "order_time": "2026-08-03T08:58:03+00:00",
  "vehicle_type": "bike",
  "fare": 10,
  "distance": 1.67,
  "driver": {
    "name": "Slider hero 2",
    "phone_number": "+971588496496",
    "latitude": 24.33163521,
    "longitude": 54.5171723,
    "vehicle": "Car"
  },
  "tracking_url": "https://slider-app.com/t/90fp-hzv8.SYhReGPNVtD5"
}

Response fields

Status values

searching_riderrider_assignedheading_to_pickupat_pickuppicked_upin_transitdeliveredreturn_trip_startedcancelled

Cancel Delivery

Cancel a delivery order. Only pending deliveries can be cancelled. Completed or already cancelled orders cannot be modified.

Example response

{
  "order_number": 20969271,
  "order_id": "12345685",
  "status": "cancelled",
  "cancelled_at": "2026-08-03T10:30:00+00:00"
}

Webhooks

Instead of polling for status, register a webhook URL in your dashboard to receive real-time updates. Slider sends a POST request to your URL every time a delivery's status changes.

Webhook payload

{
  "order_number": 20969271,
  "order_id": "12345685",
  "status": "rider_assigned",
  "estimated_delivery_time": 15,
  "tracking_link": "https://slider-app.com/t/4osd-9ary.lO_6-WOHpCmg",
  "driver_info": {
    "name": "Slider Driver",
    "phone_number": "+971502012345",
    "latitude": 24.33163521,
    "longitude": 54.5171723,
    "vehicle": "Car"
  },
  "timestamp": "2026-08-03T09:15:00+00:00"
}

Webhook fields

Webhook events

Webhooks are sent for the following status changes:

Limits & Rules

Error Codes

Example error response

{
  "success": false,
  "message": "Order could not be processed due to insufficient wallet balance."
}