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

# Scanning API

> Endpoints for triggering automated scans, querying execution status, and aborting runs.

### Trigger Scan

```http theme={null}
POST /v2/scans
```

```json theme={null}
{
  "project_id": "proj_9021a",
  "scan_profile": "full_web_audit",
  "callback_url": "https://internal-ci.company.com/snapsec-webhook"
}
```

### Check Scan Status

```http theme={null}
GET /v2/scans/{scan_id}
```

```json theme={null}
{
  "scan_id": "scan_8102a",
  "status": "in_progress",
  "progress_percentage": 68,
  "endpoints_crawled": 412,
  "findings_detected": {
    "critical": 1,
    "high": 3,
    "medium": 12
  }
}
```


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