Developer Platform

Build on the BlitzParcel API

Programmatic access to your loads and real-time delivery events. Create loads, pull GPS location snapshots, confirm payments, and subscribe to webhooks — all from your own systems.

Create a Developer Account Explore Endpoints

Core Endpoints

Everything you need to move loads

Base URL: https://app.blitzparcel.com/api/v1

GET /loads

List Loads

The 50 most recent loads on your account, ordered by creation date.

GET /loads/:unique_code

Get a Load

Full detail for a single load — status, payment status, items, and weight.

POST /loads

Create a Load

Book a pickup and drop-off with a write token. Supports multipart image uploads.

GET /loads/:unique_code/snapshots

Location Snapshots

The ordered list of GPS points recorded while a load is in transit.

GET /loads/:unique_code/payment

Get Payment

Current payment status, service fee, and total amount charged for a load.

POST /loads/:unique_code/payment

Initiate Payment

Start an online payment via Paystack and receive a checkout access code.

Quickstart

Create a load, get notified as it moves

Authenticate with a Bearer token, post a load, then listen for webhook events as a driver picks it up and delivers it.

Create a load POST /loads

Authorization: Bearer YOUR_API_TOKEN
Content-Type: application/json

{
  "load": {
    "pickup_location": "Nairobi CBD",
    "dropoff_location": "Karen Hardy",
    "payment_amount": 100,
    "vehicle_type": "motor_bike",
    "payment_type": "cash_on_delivery",
    "load_type": "small"
  }
}

Webhook event POST your_endpoint

// fired when a driver accepts the load
{
  "event": "load_assigned",
  "data": {
    "unique_code": "5a2be405208ad0f9f7a1",
    "status": "accepted",
    "pickup_location": "Nairobi CBD",
    "dropoff_location": "Karen Hardy",
    "driver": {
      "id": 2,
      "name": "Driver User1"
    }
  }
}