Errors and rate limits

Understand Kasiye API error responses and the 60-request rate limit.

The API always returns JSON on api.kasiye.com, including errors. You do not need to send Accept: application/json.

Status codes

Code	When
200	Success for list, show, quote, update, and cancel
201	Shipment created
401	Missing or invalid API key
404	Shipment reference is unknown in this workspace
422	Validation failed, route not covered, PayChangu not connected, or the shipment cannot be updated or cancelled
429	More than 60 requests in a minute for this workspace

Validation errors

422 responses include field-level messages:

{
  "message": "The pickup lat field is required.",
  "errors": {
    "pickup_lat": ["The pickup lat field is required."]
  }
}

Common create and update keys:

Key	Meaning
coverage	Pickup or dropoff is outside coverage
weight_kg	Weight is invalid or outside pricing tiers
paychangu	Connect PayChangu on the workspace before creating shipments
shipment	The shipment can no longer be updated or cancelled

Not found vs unauthorized

• No key or a bad key: 401 with Unauthenticated.
• A valid key for a shipment that belongs to another workspace: 404

Rate limits

Kasiye allows 60 requests per minute per workspace. Back off and retry when you receive 429.