get
/v1/scansList the caller's scans with filters + cursor pagination
Requires a Bearer token (session JWT or an API key with ``scans:read``). Results are scoped to the caller's own scans; admins may pass ``?all=true`` for the global view.
Parameters
| Parameters | Type | Required | Description |
|---|---|---|---|
| domain(query) | — | — | — |
| status(query) | — | — | — |
| profile(query) | — | — | Filter by scan profile (ai_ready / seo / geo / cro / wpo / ux_ui / aeo / smo / lso / vso / seco / lro / aso) |
| since(query) | — | — | — |
| until(query) | — | — | — |
| cursor(query) | — | — | — |
| limit(query) | integer | — | — |
| all(query) | boolean | — | Admin only: list every user's scans instead of just your own. |
| authorization(header) | — | — | — |
Responses
- 200Successful Response
scansarrayRequirednext_cursoranyOfOptional
- 422Validation Error
detailarrayOptional