List scans (v2)
List your organization's own Inspector scans (never a competitor's, which its scan's report lists), newest first unless sortBy names another column, filtered by hostname, lifecycle, a search over hostname and URL, or up to twenty scan ids (to poll the status of scans you started). Pages are keyset-based: nextCursor names the last scan a page listed, and the next page starts right after where that scan sorts now, so scans started, archived, or restored while you page shift nothing across a page. Set includeTotal to also count every match (totalCount, else null) and includePercentile to rank each scored scan in its industry (percentile, else null); both cost extra reads, so they are off by default.
Request
- Base URL: https://point11.ai
- URL: https://point11.ai/api/v1/inspector/scans-v2
- Auth: one of:
- HTTP bearer
- OAuth 2 (authorization code, authorization URL https://auth.point11.ai/oauth2/authorize, token URL https://auth.point11.ai/oauth2/token)
Query parameters
Number of items to return (1–1000)
nextCursor from the previous page. A page starts after the last scan the previous page listed, so scans started, archived, or restored while paging do not shift where it starts
Filter by hostname (e.g. example.com); www. and case are ignored
Only these scan ids (1–20): the table's status poll
Which scans to list; deleted scans are never listed
Search over hostname and URL
Sort column
Sort direction
Rank each scored scan in its industry (percentile); off by default, each row's percentile is null
Count every matching scan (totalCount); off by default, totalCount is null
Headers
Organization to act in. Required for OAuth bearers; an API key acts in the organization that owns it.
Response
Success.
Changes
No recorded changes to this operation across all 1 revision of this API.