diff --git a/lib/base-apis.js b/lib/base-apis.js
index cf259008a..c82301e3c 100644
--- a/lib/base-apis.js
+++ b/lib/base-apis.js
@@ -1042,9 +1042,10 @@ MatrixBaseApis.prototype.sendToDevice = function(
 // Third party Lookup API
 // ======================
 
-/*
+/**
  * Get the third party protocols that can be reached using
  * this HS
+ * @return {module:client.Promise} Resolves to the result object
  */
 MatrixBaseApis.prototype.getThirdpartyProtocols = function() {
     return this._http.authedRequestWithPrefix(
@@ -1053,12 +1054,13 @@ MatrixBaseApis.prototype.getThirdpartyProtocols = function() {
     );
 };
 
-/*
+/**
  * Get information on how a specific place on a third party protocol
  * may be reached.
  * @param {string} protocol The protocol given in getThirdpartyProtocols()
  * @param {object} params Protocol-specific parameters, as given in th
  *                        response to getThirdpartyProtocols()
+ * @return {module:client.Promise} Resolves to the result object
  */
 MatrixBaseApis.prototype.getThirdpartyLocation = function(protocol, params) {
     var path = utils.encodeUri("/thirdparty/location/$protocol", {