Error Codes Reference

Comprehensive guide to HTTP status codes and API-specific error codes for the BigCity Rewards API.

Table of Contents

HTTP Status Codes
API Status Codes
Error Handling Guide
Troubleshooting Tips

HTTP Status Codes

The BigCity Rewards API returns standard HTTP status codes to indicate the success or failure of requests. Understanding these codes helps in implementing proper error handling and user feedback.

Code Status Text Description Action Required
200 OK Request completed successfully None - Process response
301 Moved Permanently Resource has permanently moved to a new location Update endpoint URL
304 Not Modified No new data available since last request Use cached data
400 Bad Request The request was invalid or cannot be processed Validate request format and parameters
401 Unauthorized Invalid or missing authentication credentials Re-authenticate with valid credentials
404 Not Found Requested API endpoint or resource not available Verify endpoint URL and availability
500 Internal Server Error Unexpected server error occurred Retry request after delay, contact support if persistent

Example Error Responses

400 Bad Request

{
  "error": "bad_request",
  "message": "Missing required parameter: customer_mobile",
  "details": {
    "field": "customer_mobile",
    "code": "required_field_missing"
  }
}

401 Unauthorized

{
  "error": "unauthorized",
  "message": "Invalid authentication token",
  "details": {
    "code": "invalid_token",
    "token_status": "expired"
  }
}

500 Internal Server Error

{
  "error": "internal_server_error",
  "message": "An unexpected error occurred",
  "details": {
    "code": "server_error",
    "request_id": "req_123456789"
  }
}

API-Specific Error Codes

In addition to HTTP status codes, the BigCity Rewards API returns specific error codes that provide detailed information about what went wrong during request processing.

Authentication Errors

Code Message Description Resolution
32 Could not authenticate you Authentication credentials are invalid or expired Verify company secret or re-authenticate
43 Enter Valid Input Mobile number is missing from customer data Provide valid customer mobile number

Resource Not Found Errors

Code Message Description Resolution
34 Sorry, that page does not exist The requested resource or endpoint was not found Check endpoint URL and API documentation
42 Order failed Invalid SKU provided in order request Verify SKU exists in rewards catalog

Financial & Account Errors

Code Message Description Resolution
35 The funds are not sufficient in the account Insufficient balance to process the reward Contact support or try again later
44 Order failed Voucher code is not available Verify voucher availability or try different reward
45 Order failed Campaign has expired Check campaign validity dates
46 Order failed Voucher code has already been redeemed Use a different voucher or generate new one

System & Processing Errors

Code Message Description Resolution
36 Sorry, the unique code generation is getting failed System failed to generate unique voucher code Retry the request, contact support if persistent
41 Order failed Something went wrong during order processing Retry order placement, check request format

Validation Errors

Code Message Description Resolution
37 Validation Failed order_timestamp is required but missing Include valid ISO 8601 timestamp in request
38 Validation Failed order_total is required but missing Include numeric order total value
39 Validation Failed order_items count is required but missing Include total number of items in order
40 Validation Failed line_items array is required but missing Include array of line items with SKU and quantity