Information submitted through the support site is private but is not hosted within your secure CDD Vault. Please do not include sensitive intellectual property in your support requests.

Error Codes and Messages

The CDD API attempts to return appropriate HTTP status codes for every request.

Common status codes include:

  • 200 OK: request processed successfully.
  • 400 Bad Request: Can be malformed JSON syntax or a database conflict (e.g. trying to create a molecule that already exists).
  • 401 Not Authorized: either you need to provide authentication credentials, or the credentials provided aren't valid.
  • 403 Forbidden: CDD understands your request, but refuses to fulfill it. An accompanying error message should explain why.
  • 404 Not Found: either you're requesting an invalid URI or the resource in question doesn't exist (e.g. no such molecule).
  • 500 Internal Server Error: Something went wrong... Please contact support.
  • 503 No server error: usually occurs when there are too many requests coming into CDD.


The body of an error response may contain a JSON structure with more information about the nature of the error, e.g.

{"error":"Mapping not valid"}
Have more questions? Submit a request

0 Comments

Please sign in to leave a comment.