Added the getTenantsByEmailAddress endpoint

lib/api.tenants.js

@@ -118,6 +118,20 @@ var getTenants = module.exports.getTenants = function(restCtx, callback) {
     RestUtil.RestRequest(restCtx, '/api/tenants', 'GET', null, callback);
 };
 
+/**
+ * Get the tenants matching one or more email addresses
+ *
+ * @param  {RestContext}    restCtx             Standard REST Context object that contains the current tenant URL and the current user credentials. In order for this to work, a global admin rest context will need to passed in.
+ * @param  {String[]}       emails              The email addresses to get the tenants for
+ * @param  {Function}       callback            Standard callback function
+ * @param  {Object}         callback.err        Error object containing error code and error message
+ * @param  {Object}         callback.tenants    The tenants keyed by the email addresses
+
+ */
+var getTenantsByEmailAddress = module.exports.getTenantsByEmailAddress = function(restCtx, emails, callback) {
+    RestUtil.RestRequest(restCtx, '/api/tenantsByEmail', 'GET', {'emails': emails}, callback);
+};
+
 /**
  * Retrieve a tenant through the REST API.
  *