Link headers carry the next page so the body stays clean
Clients should not have to build the next URL. Send it.
Link: </events?cursor=abc>; rel="next", </events?cursor=xyz>; rel="prev"The body is just the items. A client walks the list by following rel="next" until it is absent, which is the same logic for every list in the API.
httpapi-design