Pagination

how to navigate large collections that expand multiple pages

Requests that this list entries in a collection can require pagination to navigate a large number of entries.
When a request support pagination it will respond with a Link http header.

This header includes a link to "next" page of entries, unless on the last page (use this to determine the end of the collection).

Text

Link: <https://api.securityscorecard.io/companies/example.com/...>; rel="next"

It's very important to follow these urls to traverse collections instead of constructing urls on your own. Doing so will protect your integration from future changes.

In some cases when a collection exceeds a certain size, we'll offer instead a report to asynchronously generate a dump of the entire collection.

An example of this is to Generate a Full Scorecard report
to dump all issue findings on a scorecard.