API spec to exercise common functionality

Start with a simple example of pagination

Signed-off-by: Abhijit Hiremagalur <abhi@pivotallabs.com>