Reference

Error Codes

Error responses use the same envelope with is_success: false. The HTTP status code indicates the type of error:

Status	Message	Notes
400	Invalid request / missing parameters.	Check parameter names & types.
401	API key is invalid or missing.	Include the x-api-co-id header.
402	Insufficient balance.	Top up your balance before checking shipping costs / placing orders.
403	COD is not available yet.	The COD feature is still disabled.
404	Data not found.	Wrong tracking number (AWB) / order ID.
422	Validation failed.	Check field length limits & minimum values.
429	Monthly API call limit reached for your plan	Your plan's monthly quota is used up.
500	Internal server error.	Try again; contact support if it persists.
502	Gateway error.	Upstream is temporarily unavailable.
503	Service temporarily unavailable.	Try again in a moment.

Rate Limits

The number of API calls is limited by your account plan's monthly quota. When the quota runs out, requests return 429 with the message:

Monthly API call limit reached for your plan

The quota resets at the start of each monthly cycle. To raise the limit, upgrade your account plan.