Document new API pagination headers introduced in !2426 (merged). Solves #8098 (closed).
/cc @dzaporozhets @dblessing