HTTP API

Rahhawan Dispatch API

Base URL https://api.rahhawan.com/v1. Versioned, tenant-aware, and designed so billing and routing partners never receive PHI.

POST/v1/oauth/sessionWorkspace grant

Create workspace session

OAuth-style handshake that mints a role-scoped session for pharmacy, driver, or admin.

{
  "role": "PHARMACY",
  "tenant": "PHARM-104"
}

{
  "token": "rhw_sess_8f2a91",
  "role": "PHARMACY",
  "expiresIn": 28800
}

POST/v1/deliveriesBearer pharmacy

Create delivery

Pharmacy tenant creates an order. A tracking code is issued immediately for the anonymous buffer.

{
  "patientName": "Helen Park",
  "address": "14 Maple Avenue",
  "city": "Morristown",
  "zip": "07960",
  "county": "MORRIS",
  "rxCount": 3,
  "rush": true,
  "controlled": false,
  "refrigerated": false
}

{
  "id": "del_1",
  "trackingCode": "DEL-84021",
  "status": "SUBMITTED"
}

GET/v1/deliveriesBearer session

List deliveries

Pharmacies are tenant-scoped. Admins see all. Drivers see assigned stops only.

GET /v1/deliveries?status=EN_ROUTE&flag=COLD&page=1
Authorization: Bearer rhw_sess_••••

{
  "data": [{ "trackingCode": "DEL-84023", "status": "PICKED_UP" }],
  "meta": { "page": 1, "total": 14 }
}

PATCH/v1/deliveries/{id}/statusBearer driver|admin

Advance status

Driver one-tap pipeline. Rule engine may REJECT missing temps, signatures, or CS authorization.

{ "status": "PICKED_UP", "pickupTempF": 38.4 }

{ "trackingCode": "DEL-84023", "status": "PICKED_UP", "verdict": "ALLOW" }

POST/v1/deliveries/{id}/proofBearer driver

Capture proof

Canvas signature and camera photo as data URLs stored in the PHI zone.

{ "signature": "data:image/png;base64,…", "photo": "data:image/jpeg;base64,…", "signedBy": "Helen Park" }

{ "ok": true, "status": "DELIVERED" }

GET/v1/routes/exportBearer admin

Anonymous route CSV

Three columns only: address, stop alias, operational notes. No PHI.

address,stopAlias,operationalNotes
"14 Maple Avenue, Morristown NJ 07960",DEL-84021,"Rush window · 1:00 PM–3:00 PM"

POST/v1/billing/chargesBearer admin

Anonymized charge

Stripe-compatible charge using order IDs and pharmacy aliases. Never patient or drug names.

{
  "orderId": "DEL-84025",
  "pharmacyAlias": "PHARM-104",
  "amount": 4800,
  "currency": "usd"
}

{ "stripeChargeId": "ch_8f2a94", "status": "PAID" }

PATCH/v1/drivers/{id}Bearer admin

Authorize controlled substances

Toggle CS eligibility. Restricted drug assignments reject unauthorized couriers.

{ "authorizedControlled": true }

{ "id": "drv_marcus", "authorizedControlled": true }