Error codes

Every error has the same format. The code is stable; the message is in French or English according to Accept-Language. Give the request_id to support.

{
  "error": {
    "code": "parcel_too_big",
    "message": "The parcel exceeds this vehicle's limits.",
    "request_id": "req_8b43927a…",
    "param": "parcel.size",
    "doc_url": "https://kolis.delivery/developers/errors#parcel_too_big"
  }
}

• unauthorized401Missing or invalid API key.
• key_revoked401This API key has been revoked.
• key_expired401This API key has expired.
• api_disabled503The Kolis API is not open yet.
• account_suspended403The merchant account is suspended or inactive.
• live_not_enabled403Live mode is not enabled for this account yet. Use a test key.
• ip_not_allowed403IP address not allowed for this key.
• insufficient_scope403This key does not have the required scope.
• tracking_disabled403Tracking is not enabled for this account.
• tracking_expired410This tracking link has expired.
• rate_limited429Too many requests. Retry after the indicated delay.
• daily_quota_exceeded429Daily request quota reached.
• quota_exceeded429Monthly delivery quota reached.
• too_many_open_deliveries429Too many deliveries in progress at once.
• invalid_json400The request body is not valid JSON.
• invalid_input400Missing or invalid parameter.
• invalid_vehicle400Unknown vehicle.
• invalid_parcel_size400Unknown parcel size.
• invalid_parcel_weight400Unknown parcel weight.
• invalid_recipient_phone400Invalid recipient phone (E.164 format, e.g. +237...).
• invalid_cursor400Invalid pagination cursor.
• idempotency_key_required400The Idempotency-Key header is required to create a delivery.
• invalid_idempotency_key400Invalid Idempotency-Key (128 characters max).
• idempotency_key_reused422This Idempotency-Key was already used with a different request body.
• insufficient_balance402Insufficient prepaid balance.
• not_found404Resource not found.
• quote_not_found404Quote not found.
• quote_expired409The quote has expired. Request a new one.
• quote_used409This quote has already been used.
• duplicate_external_ref409This external reference already exists.
• cannot_cancel_after_pickup409Cannot cancel: the parcel has been picked up.
• bad_status409Action not possible in the delivery's current state.
• not_covered422Address outside the served areas.
• too_far422Distance above the allowed maximum.
• parcel_too_big422The parcel exceeds this vehicle's limits. Choose a larger vehicle.
• internal_error500Internal error. Retry; give the request_id to support.