---
title: "Get screening status for a supplier"
method: GET
path: "/public/v2/suppliers/sites/screening"
tags: ["Suppliers - Sites"]
---

# Get screening status for a supplier

`GET /public/v2/suppliers/sites/screening`

Retrieve the status of the **most recent** screening request for a supplier site, using the same identifier query parameters as `GET /public/v2/suppliers/sites/find-by-identifier`.

This applies to screening started via `POST /public/v2/suppliers/sites/screening` and, once the target exists, to screening that was scheduled with `screeningPeriodInYears` on `POST /public/v2/suppliers/sites` (batch post-init screening is still attributed to your user when it runs).

**Resolution:**
- At least one of `supplierId`, `customerId`, `ownId`, or `prewaveId` must be provided.
- **Exactly one** supplier must match (same rules as `DELETE /public/v2/suppliers/sites` and `POST /public/v2/suppliers/sites/screening`). If multiple suppliers match, `400` is returned.
- The response reflects the latest screening request **you** created for that target (by request id). Use the same identifiers as in `POST /public/v2/suppliers/sites/screening` to track that request.

**Status values:**
- `New` — The request is still in progress.
- `Finished` — Screening completed; findings were found.
- `NoFindings` — Screening completed; no findings were found.
- `Aborted` — The request was rejected or an error occurred.

**Example:**
```
GET /public/v2/suppliers/sites/screening?prewaveId=102006215
```

**Required Permission**: `ACCESS_PUBLIC_SCREENING_REQUEST`

## Query parameters

- `supplierId` string
- `customerId` string
- `ownId` string
- `prewaveId` integer
- `source` string

## Response `200`

Screening status returned

- PublicScreeningStatusResponseV2 — Status and outcome of a screening request
  - `id` integer, required — The screening request ID.
  - `status` 'New' | 'Finished' | 'NoFindings' | 'Aborted', required — Current status of the screening request: New (in progress), Finished (findings found), NoFindings (no findings), Aborted (failed or rejected).
  - `periodInYears` integer, required — Screening window length in years (as requested).

## Other responses

- `400` — Bad Request - No identifier provided, or multiple suppliers match
- `403` — Forbidden - Missing ACCESS_PUBLIC_SCREENING_REQUEST permission
- `404` — Not Found - No supplier matches the identifiers, or no screening request exists for that supplier (for your user)
- `429` — 429 Too Many Requests - API rate limit exceeded. The request has been rejected because the rate limit for this endpoint has been exceeded. Default rate limits: GET requests - 100 per 10 seconds, 500 per minute; POST/PUT/PATCH/DELETE requests - 20 per 10 seconds, 100 per minute. For increased access, please contact customer success.
- `500` — 500 Internal Server Error - An unexpected error occurred on the server. The request may or may not have been processed.

---

[API](https://skmtc.net/prewave/apis/public-prewave-api.md) · [All operations](https://skmtc.net/prewave/apis/public-prewave-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/prewave/public-prewave-api/revisions/466169815b78/schema)