---
title: "Get Results Stats"
method: GET
path: "/v1/scans/results/stats"
tags: ["results"]
---

# Get Results Stats

`GET /v1/scans/results/stats`

Get user scan results stats

## Query parameters

- `offset` integer
- `limit` integer
- `host` string
- `domain` string
- `port` string
- `templates` string
- `severity` string
- `search` string
- `scan_id` string
- `time` string
- `vuln_status` string
- `tags` string
- `not_hosts` string
- `not_severity` string
- `not_templates` string
- `labels` string
- `category` string
- `is_regression` boolean
- `is_internal` boolean
- `start_date` string, date
- `end_date` string, date

## Headers

- `X-Team-Id` string

## Response `200`

Example response

- object
  - `message` string, required
  - `stats` ScanStats
    - `cves` integer, required
    - `matched` integer, required
    - `not_matched` integer, required
    - `severity` object
    - `total_count` integer, required
    - `total_scan` integer, required
    - `total_target` integer, required
    - `total_template` integer, required
    - `vuln_status` object
    - `total_regression` integer, required
    - `is_internal` integer — Count of internal vulnerabilities
    - `is_external` integer — Count of external vulnerabilities

## Other responses

- `400` — Example response
- `401` — Example response
- `499` — Example response
- `500` — Example response
- `default` — Example response

## Changes

- **2025-11-18** `41ee26b930f3` — 3 info
  - added the new optional `query` request parameter `is_internal`
  - added the optional property `stats/is_external` to the response with the `200` status
  - added the optional property `stats/is_internal` to the response with the `200` status
- **2025-10-28** `c9df54e2fb2c` — 1 info
  - endpoint added
- **2025-08-13** `c41cd7ae7718` — 1 breaking
  - api path removed without deprecation
- **2024-09-22** `407b73d9ce28` — 1 info
  - added the new optional `header` request parameter `X-Team-Id`
- **2024-04-19** `ba8a20839440` — 2 warning, 19 info
  - removed the optional property `stats` from the response with the `401` status
  - removed the optional property `stats` from the response with the `500` status
  - added the new optional `query` request parameter `labels`
  - added the new optional `query` request parameter `not_hosts`
  - …17 more

[Full history](https://skmtc.dev/projectdiscovery/apis/pdcp-api/changes/v1/scans/results/stats/get.md)

---

[API](https://skmtc.dev/projectdiscovery/apis/pdcp-api.md) · [All operations](https://skmtc.dev/projectdiscovery/apis/pdcp-api/llms.txt) · [OpenAPI document](https://skmtc.dev/projectdiscovery/apis/pdcp-api/revisions/24404c1dd282?raw)