LipaLater uses standard HTTP response codes to communicate the success or failure of an API request. Conventionally, codes in the 2xx range indicate a success. Codes in the 4xx range indicate an error e.g an error attributed to not providing all the required request params. 5xx range would mean there's an issue with LipaLater's servers.


This section on errors is not exhaustive and as we continue to test the API and cover more edge cases we will update the document accordingly. The end goal is to document all possible errors and provide a guide on how to handle them.


typestringURI reference that points to documentation containing details on the error. It basically sheds more light on the error. If no documentation exists, the default value is about:blank
titlestringA short summary of the problem.
statusstringThe HTTP status code generated by our server.
detailstringA description of the problem. Helps the client application correct the problem as opposed to giving debugging information.
Status codeDescription
200 - OKEverything worked as expected
400 - Bad RequestThe request was unacceptable, often due to missing a required parameter.
401 - UnauthorizedNo valid API key provided
402 - Request FailedThe parameters were valid but the request failed
403 - ForbiddenThe API key doesn't have permissions to perform the request.
404 - Not FoundThe requested resource doesn't exist.
429 - Too Many RequestsToo Many Requests have been sent to the server in a given amount of time
500, 502, 503, 504 - Server ErrorsSomething went wrong

Sample Error Response

"status": "403",
"type": "",
"title": "You do not have enough credit",
"detail": "Your credit limit is 1000, but the item(s) costs 20000",
"creditLimit": "1000"

Convey several errors

"title":"Your request parameters didn't validate.",
"reason":"has already been taken"
"reason":"has already been taken"
"reason":"has already been taken"

Request IDs

Each time a request is made to the LipaLater API a request ID is generated and sent back to your application in the X-Request-ID HTTP header. The request ID helps us track requests faster and accelerates issue resolution in scenarios whereby a particular request failed and you need our support.