Quickstart

Quote a covered route and create your first Kasiye shipment.

Create your first shipment with the Kasiye API. You will copy a workspace key, quote a covered route, then book the delivery.

Prerequisites

• A Kasiye workspace at kasiye.com
• PayChangu connected on that workspace (required to create shipments)
• Pickup and dropoff coordinates inside a coverage zone

Get started

1. Copy your API key

   In the dashboard, open Settings → API and copy the secret key. It starts with shp_.

   Treat the key like a password. Anyone with it can create and cancel shipments in your workspace. Rotate it from the same page if it leaks.

2. Quote the route

   Send pickup, dropoff, and weight. A covered quote returns covered: true and fee totals.

   curl -X POST https://api.kasiye.com/v1/shipments/quote \
     -H "Authorization: Bearer shp_your_key" \
     -H "Content-Type: application/json" \
     -d '{
       "pickup_lat": -13.9626,
       "pickup_lng": 33.7741,
       "dropoff_lat": -13.9833,
       "dropoff_lng": 33.7689,
       "weight_kg": 5
     }'
   

   If the area is not covered, covered is false and failure_type is coverage or weight.

3. Create the shipment

   Use the same coordinates plus customer and address fields.

   curl -X POST https://api.kasiye.com/v1/shipments \
     -H "Authorization: Bearer shp_your_key" \
     -H "Content-Type: application/json" \
     -d '{
       "customer_name": "Acme Corp",
       "customer_email": "[e-mail]",
       "pickup_address": "Area 47, Lilongwe",
       "pickup_lat": -13.9626,
       "pickup_lng": 33.7741,
       "dropoff_address": "City Centre, Lilongwe",
       "dropoff_lat": -13.9833,
       "dropoff_lng": 33.7689,
       "weight_kg": 5
     }'
   

   A successful create returns 201 with a SHP- reference, status: pending, and payment_status: awaiting_payment.

Next steps

Authentication

Bearer tokens, X-Api-Key, and rate limits.

Create shipment

Full request body, coverage errors, and PayChangu requirements.