diff --git a/API.md b/API.md
index 937720e0..9bb1e699 100644
--- a/API.md
+++ b/API.md
@@ -101,6 +101,8 @@ GeoJSON document containing the features resulting from the request query.
 
 ## Feature
 
+Produces an item from a dataset (as GeoJSON)
+
 ### Request
 Path: `/collections/{cid}/items/{fid}`
 
@@ -110,6 +112,8 @@ Path: `/collections/{cid}/items/{fid}`
 
 ### Response
 
+JSON document listing feature.
+
 #### Links
 * self - `/collections/{cid}/items/{fid}.json` - This document as JSON
 * alternate - `/collections/{cid}/items/{fid}.html` - This document as HTML
@@ -139,6 +143,8 @@ Path: `/functions/{fnid}`
 
 ### Response
 
+JSON document listing metadata.
+
 #### Links
 * self - `/functions/{fnid}.json` - This document as JSON
 * alternate - `/functions/{fnid}.html` - This document as HTML