diff --git a/api/controllers/blocks.js b/api/controllers/blocks.js
index 97c6bbb7..16209772 100644
--- a/api/controllers/blocks.js
+++ b/api/controllers/blocks.js
@@ -58,7 +58,6 @@ Blocks.heightParam = function(req, res, next, height) {
  *
  * from: block height as lower limit (default: 0)
  * to: ditto, but for the upper limit, non inclusive (default: 1000000)
- * page: for paginating results (default: 0)
  * offset: skip the first offset blocks (default: 0)
  * limit: max amount of blocks returned (default: 10)
  *
@@ -74,7 +73,9 @@ Blocks.list = function(req, res) {
     res.send('/v1/blocks/ "to" must be >= to "from"');
     return;
   }
+  // TODO: add more parameter validation
 
+  // TODO: return block_summary instead of block_full
   node.listBlocks(from, to, offset, limit)
     .then(function(blocks) {
       res.send(blocks);