---
search:
  tags:
    - Scans
    - POST
seo:
  description: >-
    Starts a paid scan of the chosen prompts on the chosen platforms and returns
    202 right… Reference for the POST /scans endpoint in the Zaraftis Public
    API.
sidebar:
  label: Start a scan
  badge: POST
title: Start a scan
type: openapi-operation
---
Starts a paid scan of the chosen prompts on the chosen platforms and returns 202 right away. The response carries the scan id, a status_url and task reference to poll, the requested query counts, and the billing object with the reserved credits. Credits come only from the workspace wallet.

`POST /scans`

**Request body** (`application/json`, required)

Request body example:

```json
{
  "setup_id": "223e7533-659b-4438-b6f4-f841a5d7dfa9",
  "prompt_selection": {
    "mode": "all"
  },
  "platform_selection": {
    "mode": "all"
  },
  "response_detail": "compact"
}
```

**Responses**

- `202` — Accepted scan (reserved billing; poll status\_url to terminal)
- `400` — bad\_request or validation\_failed
- `402` — wallet\_not\_activated, insufficient\_credits, or payment\_action\_required
- `409` — conflict, duplicate\_url, or idempotency\_conflict
- `429` — rate\_limited: wait the Retry-After seconds

Response example, 202:

```json
{
  "success": true,
  "data": {},
  "request_id": "string"
}
```