...
Reading Time: 5 minutes
Fleet Platform
Mobile App

Build Custom Integrations
with Zeo API

Connect your systems to Zeo with our RESTful API. Create routes,
track progress in real-time, and automate workflows with webhooks.

Zeo API & Webhooks, Zeo Route Planner
  • 99.9%

    API uptime SLA

  • 100ms

    Average response time

  • 20+

    API endpoints

  • 10K

    Requests/minute limit

Developer Platform Features

Everything you need to integrate route planning into your applications

  • Zeo API & Webhooks, Zeo Route Planner

    REST API

    Full-featured RESTful API for managing routes, stops, drivers, and more. JSON request/response format with comprehensive documentation.

    • Create and optimize routes programmatically
    • Manage stops, drivers, and vehicles
    • Retrieve real-time tracking data
    • Access analytics and reports
    • Bulk operations support
  • Zeo API & Webhooks, Zeo Route Planner

    Webhook Events

    Real-time event notifications pushed to your endpoints. React instantly to route changes, stop completions, and driver updates.

    • Route started/completed events
    • Stop status change notifications
    • Driver location updates
    • ETA change alerts
  • Zeo API & Webhooks, Zeo Route Planner

    Authentication

    Secure API access with industry-standard authentication. Multiple key types for different access levels and use cases.

    • Bearer token authentication
    • API key management dashboard
    • Scoped permissions per key
    • Key rotation support
    • Rate limiting per key
  • Zeo API & Webhooks, Zeo Route Planner

    Third-Party Import

    Seamlessly import orders and jobs from external systems. Automatic address validation and geocoding on import.

    • Bulk stop import endpoint
    • Address validation & geocoding
    • Custom field mapping
    • Duplicate detection
    • Import status tracking

Webhook Events

Subscribe to real-time events and react instantly to route changes

  • Frame 1707478314 20 1, Zeo Route Planner

    route.started

    Fired when a driver begins navigating a route. Includes route ID, driver info, and estimated completion time.

  • Frame 1707478314 19, Zeo Route Planner

    stop.completed

    Triggered when a stop is marked complete. Contains proof of service data, timestamps, and notes.

  • Frame 1707478314 17, Zeo Route Planner

    stop.failed

    Sent when a stop couldn’t be completed. Includes failure reason and any captured photos/notes.

  • Group 11880, Zeo Route Planner

    driver.location_update

    Periodic location updates for active drivers. Configurable frequency from 30s to 5min intervals.

  • Group 11880 1, Zeo Route Planner

    eta.changed

    Fired when estimated arrival times change significantly due to traffic or delays.

  • Group 11880 2, Zeo Route Planner

    route.completed

    Triggered when all stops are done. Includes final stats, duration, and performance metrics.

  • // Webhook payload example
    {
      "event": "stop.completed",
      "timestamp": "2024-01-15T14:32:00Z",
      "data": {
        "route_id": "route_abc123",
        "stop_id": "stop_xyz789",
        "driver": {
          "id": "drv_456",
          "name": "John Smith"
        },
        "completed_at": "2024-01-15T14:31:45Z",
        "proof": {
          "signature": "https://...",
          "photos": ["https://..."],
          "notes": "Left at door"
        }
      }
    }

    API Endpoints Overview

    Core endpoints for route planning and fleet management

    POST
    /v1/routes

    Create a new route with stops and optimization settings

    GET
    /v1/routes/{id}

    Retrieve route details including optimized sequence

    POST
    /v1/routes/{id}/optimize

    Re-optimize an existing route with updated parameters

    GET
    /v1/routes/{id}/tracking

    Get real-time tracking data for active route

    POST
    /v1/stops/import

    Bulk import stops from external systems

    PUT
    /v1/stops/{id}/status

    Update stop status (completed, failed, skipped)

    GET
    /v1/drivers

    List all drivers with availability status

    GET
    /v1/drivers/{id}/location

    Get current location and route progress

    POST
    /v1/webhooks

    Register webhook endpoint for event notifications

    Code Examples

    Get started quickly with examples in your favorite language



    # Create and optimize a route with multiple stops
    curl -X POST "https://api.zeoroute.com/v1/routes" \
      -H "Authorization: Bearer $ZEO_API_KEY" \
      -H "Content-Type: application/json" \
      -d '{
        "name": "Morning Deliveries",
        "driver_id": "drv_123",
        "optimize": true,
        "start_location": {
          "address": "123 Warehouse St, City"
        },
        "stops": [
          {
            "address": "456 Customer Ave",
            "time_window": {"start": "09:00", "end": "12:00"},
            "service_time": 15
          },
          {
            "address": "789 Business Blvd",
            "priority": "high",
            "service_time": 30
          }
        ]
      }' # Get route details
    curl -X GET "https://api.zeoroute.com/v1/routes/route_abc123" \
      -H "Authorization: Bearer $ZEO_API_KEY" # Update stop status
    curl -X PUT "https://api.zeoroute.com/v1/stops/stop_xyz789/status" \
      -H "Authorization: Bearer $ZEO_API_KEY" \
      -H "Content-Type: application/json" \
      -d '{"status": "completed", "notes": "Left at door"}'

    Integration Use Cases

    Automated updates work for any industry with scheduled visits

    DELIVERY

    Order Management Integration

    An e-commerce platform automatically imports new orders via API every hour. Orders are grouped by region, optimized into routes, and dispatched to drivers. Webhook notifications update order status in real-time as deliveries complete.

    FIELD SERVICE

    CRM-Driven Service Scheduling

    A field service company syncs work orders from their CRM via API. New jobs automatically create stops with customer details, service requirements, and time windows. Completion webhooks update the CRM and trigger invoicing.

    Group 1707478361, Zeo Route Planner

    Ready to Build Your Integration?

    Get your API key and start building in minutes with our comprehensive documentation

    Group 1707478363, Zeo Route Planner

    Zeo Questionnaire

    Frequently
    Asked
    Questions

    Know More

    Zeo API & Webhooks

    What are the API rate limits?

    Standard API keys allow 1,000 requests per minute. Enterprise plans can request higher limits up to 10,000 requests per minute. Rate limit headers are included in every response so you can track your usage.

    How do I authenticate API requests?

    All API requests require a Bearer token in the Authorization header. You can generate API keys from your account settings. Keys can be scoped to specific permissions (read-only, write, admin) and IP addresses.

    Do you have SDKs for different languages?

    We provide official SDKs for JavaScript/Node.js and Python. Community-maintained SDKs are available for Ruby, PHP, and Go. All SDKs are open-source and available on GitHub.

    How do webhook retries work?

    If your endpoint returns a non-2xx response, we retry with exponential backoff: 1 minute, 5 minutes, 30 minutes, 2 hours, and 24 hours. After 5 failed attempts, the webhook is marked as failed and you're notified via email.

    Is there a sandbox environment for testing?

    Yes, we provide a full sandbox environment at api-sandbox.zeoroute.com. Sandbox has the same API but with test data and no charges. Perfect for development and integration testing.

    Is the API available on all plans?

    The Zeo REST API is available on Fleet Management and Enterprise plans. It includes full route management, stop operations, driver management, and webhook support for real-time event notifications.

    Zeo Blogs

    Explore our blog for insightful articles, expert advice, and inspiring content that keeps you informed.

    2026 01 06 Pool Service Route Scheduling Software Featured, Zeo Route Planner

    Pool Service Route Scheduling Software: Complete Guide 2026

    Reading Time: 8 minutesTransform your pool service operations with route scheduling software. Cut 2-3 hours of daily planning, handle seasonal demand, and optimize multi-crew routes.

    2026 01 06 Multiple Delivery Runs Optimization Auto Parts Featured, Zeo Route Planner

    Multiple Delivery Runs Optimization for Auto Parts Distributors

    Reading Time: 9 minutesTransform chaotic multiple delivery runs into streamlined auto parts operations. Cut costs 25-30% with smart optimization strategies for urgent deliveries.

    2026 01 06 How To Reduce Auto Parts Delivery Times Featured, Zeo Route Planner

    How to Reduce Auto Parts Delivery Times by 40% in 2026

    Reading Time: 6 minutesDiscover proven strategies to reduce auto parts delivery times by 40%. Learn route optimization, emergency handling, and tech solutions for faster deliveries.