Scans API

Endpoints for managing scans.

List Scans


GET /v1/scans

Parameters

Parameter	Type	Description
`limit`	number	Max results (default: 50)
`offset`	number	Pagination offset
`since`	string	ISO date filter

Response


{
  "scans": [
    {
      "id": "scan_abc123",
      "created_at": "2024-01-15T10:30:00Z",
      "tool": "cursor",
      "tokens": 1250,
      "status": "completed"
    }
  ],
  "total": 142
}

Get Scan


GET /v1/scans/:id

Response


{
  "id": "scan_abc123",
  "created_at": "2024-01-15T10:30:00Z",
  "tool": "cursor",
  "tokens": 1250,
  "status": "completed",
  "violations": []
}

Submit Scan


POST /v1/scans

Body


{
  "tool": "cursor",
  "action": "chat",
  "tokens": 1250
}

This endpoint is typically called by the CLI, not directly.