Responses
techrar API Error Handling
Error Response Format
{
"error": {
"code": "-404",
"messages": ["Item does not exist"]
}
}code: A numeric error code (as a string or integer).messages: An array of error message strings. Usually, the first message is the most relevant.Error Codes
{item}) that will be replaced with context-specific values.| Code | Message | Meaning |
|---|---|---|
| -101 | Invalid token | The provided JWT token is invalid or expired |
| -102 | This field is required | A required field is missing in the request |
| -103 | The image size exceeds 500 KB and can't be processed | Image upload failed due to size limit |
| -104 | You can not update this item variant as a standalone | Attempt to update a dependent variant item independently |
| -105 | Date should be null for non scheduled items | Date field must be empty for non-scheduled items |
| -106 | You can not attach a category to itself or to one of its sub-categories | Invalid category hierarchy - circular reference detected |
| -107 | Order must be in pending status | Operation requires order to be in pending state |
| -108 | Invoice must be paid | Operation requires invoice to be in paid state |
| -109 | Invalid refund amount | The refund amount specified is invalid |
| -110 | There is no payment recorded for this invoice | Cannot process refund for unpaid invoice |
| -111 | Checkout session has expired | The checkout session timeout occurred |
| -112 | Item {item} in your cart requires your location/branch | Location or branch selection required for cart item |
| -113 | Item {item} is out of stock | Requested item is not available in inventory |
| -114 | Item {item} has only {quantity} remaining in stock | Requested quantity exceeds available stock |
| -115 | We couldn't refund this invoice. Please contact us | Refund operation failed |
| -116 | You have to select at least {min} items from {group} | Minimum selection requirement not met |
| -117 | You have to select at most {max} items from {group} | Maximum selection limit exceeded |
| -118 | Item {item} in your cart is offered in {city} only | Item is not available in selected city |
| -119 | Item {item} in your cart is offered for {branch} branch only | Item is not available in selected branch |
| -120 | The order only supports delivery | Pickup service is not available for this order |
| -121 | The order only supports pickup | Delivery service is not available for this order |
| -122 | You need to login to be able to redeem or apply vouchers | Authentication required for voucher operations |
| -123 | You already logged in | Duplicate login attempt |
| -124 | The order doesn't belong to a customer | Customer association required for payment method |
| -125 | Cannot update the status of a subscription fulfillment | Invalid subscription fulfillment status update |
| -126 | Cannot update the service type of a fulfillment | Invalid fulfillment service type modification |
| -127 | Booking date is required for item {item} | Missing booking date for schedulable item |
| -128 | Subscription has ended or got canceled | Operation on inactive subscription |
| -129 | Auto-renewal is already disabled | Redundant auto-renewal disable request |
| -301 | Oops!. Something went wrong, please contact us | Generic system error |
| -302 | Default: {message} | Default error message template |
| -400 | Method "{method}" not allowed / ({data}) is missing | Invalid HTTP method or missing data |
| -401 | {message} | Unauthorized access |
| -404 | {item} not found / {item} with ID ({id}) is not found | Resource not found |
{item}, {id}, {min}, {max}, {group}, {city}, {branch}, and {message} will be replaced with actual values in the error response.Modified at 2025-11-23 09:51:46