---
title: "GET /JSON/ascan/action/scan/"
method: GET
path: "/JSON/ascan/action/scan/"
tags: ["ascan"]
---

# GET /JSON/ascan/action/scan/

`GET /JSON/ascan/action/scan/`

Runs the active scanner against the given URL or Context. Optionally, the 'recurse' parameter can be used to scan URLs under the given URL, the parameter 'inScopeOnly' can be used to constrain the scan to URLs that are in scope (ignored if a Context is specified), the parameter 'scanPolicyName' allows to specify the scan policy (if none is given it uses the default scan policy), the parameters 'method' and 'postData' allow to select a given request in conjunction with the given URL.

## Response `default`

Error of JSON endpoints.

- ErrorJson
  - `code` string, required
  - `message` string, required
  - `detail` string

## Changes

> 4 revisions in range; 1 could not be searched.

- **2023-09-29** `3a1d8df7169d` — 1 breaking, 1 info
  - the `code` response's property type/format changed from `integer`/`` to `string`/`` for status `default`
  - added the optional property `detail` to the response with the `default` status
- **2019-10-10** `c7cc14d831c3` — 1 breaking, 1 warning
  - the `code` response's property type/format changed from `string`/`` to `integer`/`` for status `default`
  - removed the optional property `detail` from the response with the `default` status

[Change history](https://skmtc.dev/zaproxy/apis/zap-api/changes/JSON/ascan/action/scan/get.md)

---

[API](https://skmtc.dev/zaproxy/apis/zap-api.md) · [All operations](https://skmtc.dev/zaproxy/apis/zap-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/zaproxy/zap-api/revisions/bbb71f68ed4c/schema)