Error Handling

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

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

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.

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."
}