document browsing and paging in the API

Signed-off-by: Johannes Dewender <github@JonnyJD.net>
summary for submission and exceptions in the API

Signed-off-by: Johannes Dewender <github@JonnyJD.net>