# 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

```json
{
  "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**

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

```

**404 Resource Not Found**

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

```

**500 Internal Server Error**

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

```

***
