---
title: "Get Scan Statuses"
method: POST
path: "/api/cmp/v1/webscans/status"
tags: ["Scans"]
---

# Get Scan Statuses

`POST /api/cmp/v1/webscans/status`

## Request

- Base URL: `https://hostname`
- URL: `https://hostname/api/cmp/v1/webscans/status`
- Auth: OAuth 2
  - Client credentials
  - Token URL: `https://{hostname}/api/access/v1/oauth/token` scopes: `COOKIE`, `COOKIE_READ`

Use this API to retrieve the status of the specified scans.

## Request body

- string[]

## Response `200`

OK

- ScanStatusResponse[]
  - `scanId` string, uuid: The unique identifier of the scan.
  - `status` 'QUEUED' | 'PENDING' | 'INPROGRESS' | 'MIGRATION_STARTED' | 'MIGRATION_COMPLETED' | 'CATEGORIZATION_STARTED' | 'CATEGORIZATION_FAILED' | 'COMPLETED' | 'ERROR' | 'CANCELLED' | 'SCANNING' | 'DATA_MOVE' | 'RETRY_BY_AUTO_CORRECT' | 'MS_IOS_SCAN_SUCCESS' | 'MS_IOS_SCAN_FAILED' | 'MS_EXPORT_XLS_STARTED' | 'MS_EXPORT_PDF_STARTED' | 'SCHEDULED': The current state or condition of the item.
  - `message` string: The message or notification text.

## Other responses

- `400`: Bad Request
- `401`: Unauthorized
- `403`: Forbidden
- `429`: Too Many Requests. For more information, see [API Rate Limits](https://developer.onetrust.com/onetrust/reference/rate-limits-overview).
- `500`: Internal Server Error

---

[API](https://skmtc.dev/onetrust/apis/consent-preferences-cookie-consent.md) - [All operations](https://skmtc.dev/onetrust/apis/consent-preferences-cookie-consent/llms.txt) - [OpenAPI document](https://skmtc.dev/onetrust/apis/consent-preferences-cookie-consent/revisions/b4fb4606f973?raw)