DELAMOVES API Documentation

Business Integration Guide

🚀 Quick Start

1. Get API Keys

Register your business and get your API key from the dashboard

2. Make API Calls

Use our REST API to create deliveries programmatically

3. Setup Webhooks

Configure webhooks for automatic delivery creation

📡 API Reference

Authentication

All API requests require authentication using your API key in the Authorization header:

Authorization: Bearer YOUR_API_KEY

Create Delivery

POST/api/business/deliveries

Required Fields:

  • • pickup_address - Where to pick up the package
  • • delivery_address - Where to deliver the package
  • • customer_name - Recipient's full name
  • • customer_phone - Recipient's phone number
  • • items_description - Description of items being delivered

Optional Fields:

  • • customer_email - Recipient's email
  • • order_value - Total order value
  • • business_order_id - Your internal order ID
  • • delivery_type - standard, express (default: standard)
  • • delivery_speed - regular, express, next_day (default: regular)
cURL
curl -X POST https://yourapp.com/api/business/deliveries \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "pickup_address": "123 Restaurant St, City, State",
    "delivery_address": "456 Customer Ave, City, State",
    "customer_name": "John Doe",
    "customer_phone": "+1234567890",
    "customer_email": "john@example.com",
    "items_description": "2x Pizza, 1x Soda",
    "order_value": "25.99",
    "business_order_id": "ORDER-123"
  }'

Get Deliveries

GET/api/business/deliveries

Query Parameters:

  • • limit - Number of deliveries to return (default: 50)
  • • offset - Number of deliveries to skip (default: 0)
  • • status - Filter by status (pending, approved, in_transit, delivered, cancelled)

💻 Code Examples

JavaScript/Node.js

JavaScript
// Create a delivery
const response = await fetch('/api/business/deliveries', {
  method: 'POST',
  headers: {
    'Authorization': 'Bearer YOUR_API_KEY',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    pickup_address: '123 Restaurant St, City, State',
    delivery_address: '456 Customer Ave, City, State',
    customer_name: 'John Doe',
    customer_phone: '+1234567890',
    customer_email: 'john@example.com',
    items_description: '2x Pizza, 1x Soda',
    order_value: '25.99',
    business_order_id: 'ORDER-123'
  })
});

const data = await response.json();
console.log('Tracking Number:', data.tracking_number);

PHP

PHP
<?php
// PHP example for WooCommerce or custom integration
$data = [
    'pickup_address' => '123 Restaurant St, City, State',
    'delivery_address' => '456 Customer Ave, City, State',
    'customer_name' => 'John Doe',
    'customer_phone' => '+1234567890',
    'items_description' => '2x Pizza, 1x Soda',
    'order_value' => '25.99',
    'business_order_id' => 'ORDER-123'
];

$ch = curl_init();
curl_setopt($ch, CURLOPT_URL, 'https://yourapp.com/api/business/deliveries');
curl_setopt($ch, CURLOPT_POST, 1);
curl_setopt($ch, CURLOPT_POSTFIELDS, json_encode($data));
curl_setopt($ch, CURLOPT_HTTPHEADER, [
    'Authorization: Bearer YOUR_API_KEY',
    'Content-Type: application/json'
]);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);

$response = curl_exec($ch);
curl_close($ch);

$result = json_decode($response, true);
echo 'Tracking Number: ' . $result['tracking_number'];
?>

🔗 Webhook Integration

Automatic Delivery Creation

Connect your ecommerce platform to automatically create deliveries when orders are placed.

Webhook URL: https://yourapp.com/api/webhooks/ecommerce

Supported Platforms:

Shopify
Shopify Setup
// Shopify Webhook URL: https://yourapp.com/api/webhooks/ecommerce
// Set this in your Shopify admin under Settings > Notifications

// The webhook will automatically create deliveries when orders are placed
// Make sure your business account is approved and webhook URL is configured
WooCommerce
WooCommerce Setup
// WooCommerce Webhook URL: https://yourapp.com/api/webhooks/ecommerce
// Set this in WooCommerce > Settings > Advanced > Webhooks

// Topic: Order created
// Delivery URL: https://yourapp.com/api/webhooks/ecommerce
// Secret: (your webhook secret from business dashboard)

💰 Pricing

Standard

$15

per delivery + 15% commission

Express

$25

per delivery + 15% commission

Custom

Contact

for high-volume businesses

🎧 Support

Need Help?

Our team is here to help you integrate and get the most out of our delivery platform.

API Status

All systems operational

Check our status page for real-time API performance and uptime.