Respatch
Respatch
RespatchRespatch
Developer Portal

API-First Logistics Infrastructure.

Deterministic routing and order orchestration for global networks. Build with confidence using our comprehensive API primitives.

Integration Lifecycle

From account creation to real-time orchestration.

Step 01

Account & Organization

Establish your identity in the ledger ecosystem. Manage billing, teams, and default warehouse nodes.

Step 02

API Key Slots

Generate 4 cryptographic slots for test and live networks with public and secret authorization scopes.

Step 03

Pre-Funded Settlement

Fund your balance via Paystack. Automated debits settle per confirmed dropoff without hidden fees.

Step 04

Deterministic Dispatch

Send JSON payloads defining pickup, dropoff, and SLA constraints. Respatch computes the route and driver match.

Step 05

Webhooks & DLQ Stream

Receive HMAC SHA-256 verified callbacks on state transitions. Replay failed webhooks anytime with DLQ retry.

Official Client Libraries

Production-ready SDKs with complete type coverage and automatic signature verification.

import { Respatch } from "@respatch/sdk";

const client = new Respatch({
  apiKey: process.env.RESPATCH_SECRET_KEY!,
  environment: "sandbox", // or "production"
});

// Quote and dispatch a load
const quote = await client.quotes.create({
  pickup: { address: "14 Logistics Blvd, Ikeja, Lagos" },
  dropoff: { address: "8 Commercial Ave, Yaba, Lagos" },
  package: { weight_kg: 4.5, category: "electronics" },
});

const delivery = await client.deliveries.create({
  quote_id: quote.id,
  recipient: { name: "Amina Yusuf", phone: "+2348012345678" },
});

console.log(`Dispatched: ${delivery.id} (Status: ${delivery.status})`);

Core API Endpoints

Deterministic REST endpoints secured with API secret tokens.

/api/v1/delivery-orders
POST

Create a delivery from a locked quote_id. Contacts and package metadata only.

/api/v1/delivery-orders/quote
POST

Lock fare, vehicle, and route before you commit wallet funds.

/api/v1/delivery-orders/{id}/track
GET

Package status, rider snapshot, and handover embed URLs.

/api/v1/delivery-orders/{id}/cancel
POST

Cancel an open order and refund a wallet charge when eligible.