diff --git a/bigchaindb/commands/bigchaindb.py b/bigchaindb/commands/bigchaindb.py
index 9be0b244..5bf4a677 100644
--- a/bigchaindb/commands/bigchaindb.py
+++ b/bigchaindb/commands/bigchaindb.py
@@ -140,6 +140,15 @@ def run_upsert_validator_new(args, bigchain):
 
 
 def run_upsert_validator_show(args, bigchain):
+    """Retrieves information about an upsert-validator election
+
+    :param args: dict
+        args = {
+        'election_id': the transaction_id for an election (str)
+        }
+    :param bigchain: an instance of BigchainDB
+    :return: (public_key, power, node_id) for the proposed change to the validator set
+    """
 
     election = bigchain.get_transaction(args.election_id)