---
title: "Trigger Live Scan"
method: POST
path: "/api/v1/livescan/{scannerId}/scan/"
tags: ["Live Scanning"]
---

# Trigger Live Scan

`POST /api/v1/livescan/{scannerId}/scan/`

Task a URL to be scanned. The HTTP request will **block** until the scan has finished.

## Path parameters

- `scannerId` string, required

## Request body

- LivescanRequest
  - `task` object, required
    - `url` string, uri, required — URL to scan
    - `visibility` 'public' | 'unlisted' | 'private'
    - `tags` string[] — User-defined tags to annotate this scan, e.g. "phishing" or "malicious".
  - `scanner` object
    - `pageTimeout` integer — Time to wait for the whole scan process (in ms)
    - `captureDelay` integer — Delay after page has finished loading before capturing page content
    - `extraHeaders` object — Extra Key-Value headers to send via the HTTP headers
    - `enableFeatures` string[]
    - `disableFeatures` string[]

## Response `200`

OK

- object
  - `uuid` string, uuid — UUID of scan

---

[API](https://skmtc.net/urlscan/apis/urlscan-io-apis.md) · [All operations](https://skmtc.net/urlscan/apis/urlscan-io-apis/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/urlscan/urlscan-io-apis/revisions/5d97b31afd68/schema)