API error codes

Error codes are being sent by Clickpost in the API response. You can refer to this for building resilient systems and putting in place an error-handling mechanism

Server Response Code

Server Response CodeMeaning
200Success
400Bad Request
401Unauthorized
403Forbidden
404Not Found
405Method Not Allowed
406Not Acceptable
429Too Many Requests
500Internal Server Error
503Service Unavailable
504"Server unable to serve the request, please retry"

Clickpost Service Error Code

Clickpost Service Error CodeMeaning
301Authentication Failed: Invalid Token or API Key
302Invalid Courier Partner Id with Field cp_id
303waybill already registered
304Already Registered For Service
306"You are not Registered To Use this service, Please Register"
316You Dont Have Credentials For The Courier Partner
320This service is not subscribed by you
324"You Are Using Invalid Credential For Courier Partner, Please Update"
325"Status You Are Trying to update is invalid for our systems, Contact to [email protected]"
326Invalid Tracking Id
328Invalid POST data
330waybill does not exist
351No account exist
352Multiple Account exist
353Inactive account
354Unhandled CP error
355Vendor code not found
422Invalid Entity

Order Creation Error Code

Order Creation Error CodeMeaning
307You have entered an invalid Order Type
308You have entered an invalid Order Priority
309Invalid Delivery Type
310RVP reason is missing
311Invalid Courier Partner For RVP
312Items Data is missing from order details
313Invalid Format of items for Order data
314Invalid Format Of Order Data
315Invalid Cod Value
319Error In Order Placing To Courier Partner
321Awb Number Does not exist in the system for the courier partner
322"Internal Server Error In Courier Partners Server, Try Again"
323You have already placed this order

Clickpost Webhook Error Code

Clickpost Webhook Error CodeMeaning
305Webhook already Registered for the user
327Webhook not registered for the user

Order Cancellation Error Code

MeaningOrder Cancellation Error Code
Order already canceled600
Order Cancellation Error from Courier Partner Server350
Cancellation request received, failed over API, will be mailed to the couriers [Applicable for couriers where cancel request is sent via mail post API failure]202