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

# List scans

> Read scan history with filters and pagination.

Returns the scans of the key's organization, newest first.

## Request

**Authorization** `string` *required*

`Bearer rvx_YOUR_KEY`

**page** `integer`

Page number, starting at 1.

**size** `integer`

Page size: `10`, `20` or `50`.

**filter** `string` (default: all)

One of `all`, `ban`, `review`, `clear`, `running`.

**q** `string`

Search text, matched against scan details such as the label.

```bash cURL theme={null}
curl "https://revexscanner.com/api/v1/scans?filter=review&size=20" \
  -H "Authorization: Bearer rvx_YOUR_KEY"
```

```javascript Node.js theme={null}
const res = await fetch("https://revexscanner.com/api/v1/scans?filter=review&size=20", {
  headers: { Authorization: `Bearer ${process.env.REVEX_KEY}` },
});
const { items, total } = await res.json();
```

## Response

**items** `object[]`

The scans on this page.

**item fields**

**id** `string`

Scan session ID.

**createdAt** `number`

Creation time, Unix milliseconds.

**startedAt** `number`

When the scan actually started. Missing if it has not started.

**expiresAt** `number`

PIN expiry, Unix milliseconds.

**status** `string`

`pending`, `consented`, `started`, `submitted` or `expired`.

**category** `string`

`ban`, `review`, `clear`, `running` or `expired`.

**target** `string`

The label you set when creating the scan, if any.

**pin** `string`

Only while the scan is `pending` or `consented`.

**reportId** `string`

Present once a report exists.

**counts** `object`

`{ "critical": number, "risky": number }`. Only for scans with a report.

**decision** `string`

`ban` or `clear`, once staff has decided.

**total** `number`

Number of scans matching the filter.

**page** `number`

Current page.

**pageSize** `number`

Page size in use.

**counts** `object`

Totals per filter and for expired scans.

```json 200 theme={null}
{
  "items": [
    {
      "id": "0-9b9d5dab-6975-4561-8303-8db8379f9ca5",
      "createdAt": 1795300000000,
      "startedAt": 1795300120000,
      "expiresAt": 1795386400000,
      "status": "submitted",
      "category": "review",
      "target": "ticket-1042",
      "reportId": "r-123",
      "counts": { "critical": 0, "risky": 3 }
    }
  ],
  "total": 1,
  "page": 1,
  "pageSize": 20,
  "counts": { "all": 1, "ban": 0, "review": 1, "clear": 0, "running": 0, "expired": 0 }
}
```

## Errors

| Status | Code | Meaning |
| - | - | - |
| 401 | `INVALID_API_KEY` | The key is missing, wrong or revoked. |
| 429 | `RATE_LIMITED` | Too many requests. Wait a minute. |


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.