> ## Documentation Index
> Fetch the complete documentation index at: https://docs.kasiye.com/llms.txt
> Use this file to discover all available pages before exploring further.

# 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](https://kasiye.com)
* PayChangu connected on that workspace (required to create shipments)
* Pickup and dropoff coordinates inside a coverage zone

## Get started

<Steps>
  <Step title="Copy your API key">
    In the dashboard, open **Settings → API** and copy the secret key. It starts with `shp_`.

    <Warning>
      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.
    </Warning>
  </Step>

  <Step title="Quote the route">
    Send pickup, dropoff, and weight. A covered quote returns `covered: true` and fee totals.

    ```bash theme={null}
    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`.
  </Step>

  <Step title="Create the shipment">
    Use the same coordinates plus customer and address fields.

    ```bash theme={null}
    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": "logistics@acme.com",
        "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`.
  </Step>
</Steps>

## Next steps

<CardGroup cols={2}>
  <Card title="Authentication" icon="key" href="/authentication">
    Bearer tokens, X-Api-Key, and rate limits.
  </Card>

  <Card title="Shipment statuses" icon="list-check" href="/guides/statuses">
    Delivery path, payment states, and when you can update, advance, or cancel.
  </Card>

  <Card title="Create shipment" icon="plus" href="/api-reference/create-shipment">
    Full request body, coverage errors, and PayChangu requirements.
  </Card>
</CardGroup>