> ## Documentation Index
> Fetch the complete documentation index at: https://api.thesapientcompany.com/llms.txt
> Use this file to discover all available pages before exploring further.

# List scans

> Page through your org's scan history.

Return your org's scans, newest first. Each entry is a lightweight summary: `scan_id`, `input`, `lenses`, the written `summary`, and `created_at`. To read the full per-second timeline for any one of them, fetch it with [Get a scan](/api-reference/get-scan).

Scans are strictly org-scoped: you only ever see your own org's history.

## Query Parameters

<ParamField query="limit" type="integer" default="25">
  How many scans to return. Clamped to `1–100`.
</ParamField>

<ParamField query="offset" type="integer" default="0">
  How many scans to skip, for paging through the history.
</ParamField>

## Response

<ResponseField name="object" type="string">Always `list`.</ResponseField>
<ResponseField name="total" type="number">Total scans in your org's history.</ResponseField>
<ResponseField name="limit" type="number">The applied page size.</ResponseField>
<ResponseField name="offset" type="number">The applied offset.</ResponseField>

<ResponseField name="scans" type="object[]">
  The page of scans.

  <Expandable title="scans[]">
    <ResponseField name="scan_id" type="string">The scan identifier. Pass it to [Get a scan](/api-reference/get-scan).</ResponseField>
    <ResponseField name="input" type="object">What was scanned: `{ kind, value }` (e.g. a URL or a text snippet).</ResponseField>
    <ResponseField name="lenses" type="string[]">The lenses this scan was scored against.</ResponseField>
    <ResponseField name="summary" type="string">The written read of the clip.</ResponseField>
    <ResponseField name="created_at" type="string">ISO 8601 timestamp.</ResponseField>
  </Expandable>
</ResponseField>

<RequestExample>
  ```bash cURL theme={null}
  curl "https://www.thesapientcompany.com/api/v1/scans?limit=3" \
    -H "Authorization: Bearer sk_live_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"
  ```
</RequestExample>

<ResponseExample>
  ```json List (trimmed) theme={null}
  {
    "object": "list",
    "total": 4,
    "limit": 3,
    "offset": 0,
    "scans": [
      {
        "scan_id": "mary_run_mq7aht79_hrac1kka",
        "input": { "kind": "url", "value": "https://www.instagram.com/reel/DZX0pkERJsE/" },
        "lenses": ["attention", "purchase_intent", "manipulation"],
        "summary": "Across the clip, attention averaged a solid 68, the pull toward buying sat at 60, and emotional persuasion stayed in the middle range at 48 …",
        "created_at": "2026-06-10T00:35:18.756+00:00"
      },
      {
        "scan_id": "mary_run_mq7ahvvn_789mregx",
        "input": { "kind": "url", "value": "https://www.instagram.com/reel/DZF8MpCJz1y/" },
        "lenses": ["attention", "purchase_intent", "manipulation"],
        "summary": "Across the clip, attention averaged 67, the pull toward buying averaged 60, and the emotional persuasion level averaged 48 …",
        "created_at": "2026-06-09T23:51:07.782+00:00"
      }
      // … up to `limit` scans
    ]
  }
  ```
</ResponseExample>