Error Handling

All Akowe Issuance API endpoints follow a standard error response format. You should always handle these errors gracefully in your integration.

Error Response Format

{
  "success": false,
  "message": "Error description here"
}

Common Error Codes

Status Code	Error Type	Description
400	Bad Request	The request is invalid or missing required parameters.
401	Unauthorized	The API key provided is missing, invalid, or expired.
403	Forbidden	You do not have permission to access this resource.
404	Resource Not Found	The requested resource (e.g., organization, certificate) does not exist.
429	Too Many Requests	You have exceeded the allowed rate limit. Retry after some time.
500	Internal Server Error	A problem occurred on Akowe’s servers. Try again later.

Sample Error Responses

401 Unauthorized

{
  "success": false,
  "message": "Invalid or missing API key"
}

404 Resource Not Found

{
  "success": false,
  "message": "The requested organization could not be found"
}

500 Internal Server Error

{
  "success": false,
  "message": "An unexpected error occurred. Please try again later."
}

---