API Reference
Start typing to search…

Error Registry

NotFoundProblem

This problem occurs when the requested resource could not be found.

Your client application tried to access a resource that does not exist (or could not be found). Please review how your users initiated such a request.

Example:

{
  "detail": "The requested resource was not found",
  "status": 404,
  "title": "Not Found",
  "type": "https://developers.kudosity.com/reference/errors#not-found"
}

InternalServerErrorProblem

This problem occurs when the server encounters an unexpected condition that prevents it from fulfilling the request.

Your client application did everything correct. Unfortunately our API encountered a condition that resulted in this problem.

Example:

{
  "detail": "The server encountered an unexpected error",
  "status": 500,
  "title": "Server Error",
  "type": "https://developers.kudosity.com/reference/errors#server-error"
}

UnauthorizedProblem

HTTP 401 Unauthorized - API authentication failed.

The request was rejected because the API key is missing, invalid, expired, or lacks sufficient permissions for this resource. Check your Authorization header and API key configuration.

Example:

{
  "detail": "Missing or invalid API key in Authorization header. Verify your API key is correct and has the required permissions",
  "status": 401,
  "title": "API Authentication Failed",
  "type": "https://developers.kudosity.com/reference/errors#unauthorized"
}

InputValidationProblem

This problem occurs when the request is deemed unprocessable.

Your client issued a request that failed validation. Certain validation libraries return multi-errors and cannot be easily parsed into discreet types. This problem type, afforded the provider with the ability to surface all validation errors and negate the need for a trial and error workflow on your side.

Example:

{
  "detail": "The request contained invalid, or malformed parameters.",
  "issues": [
    {
      "code": 2200,
      "field": "account_id",
      "message": "The account_id supplied was invalid."
    }
  ],
  "status": 422,
  "title": "Invalid Input Parameters",
  "type": "https://developers.kudosity.com/reference/errors#input-validation"
}

Example:

{
  "detail": "The request contained invalid, or malformed parameters.",
  "issues": [
    {
      "code": 2200,
      "field": "account_id",
      "message": "The account_id supplied was invalid."
    }
  ],
  "status": 422,
  "title": "Invalid Input Parameters",
  "type": "https://developers.kudosity.com/errors#input-validation"
}