API Error Handling

← Back to API Reference

---

Table of Contents

• Common Error Responses
• Error Handling Flow

---

Common Error Responses

400 Bad Request

{
  "error": "Invalid JSON format"
}

Causes:

• Malformed JSON
• Missing required fields
• Invalid data types

404 Not Found

{
  "error": "Resource not found"
}

Causes:

• Subscriber/profile/entity doesn't exist
• Incorrect ID in URL

422 Unprocessable Entity

{
  "errors": {
    "imsi": ["has already been taken"],
    "key_set_id": ["does not exist"]
  }
}

Causes:

• Validation failures
• Database constraints violated
• Foreign key references don't exist

500 Internal Server Error

{
  "error": "Internal server error"
}

Causes:

• Database connectivity issues
• Unexpected application errors

---

Error Handling Flow

---

← Back to API Reference