---
title: "Get Nps Stats"
method: GET
path: "/api/nps/stats"
tags: ["nps"]
---

# Get Nps Stats

`GET /api/nps/stats`

## Request

- Base URL: `https://api.ruzora.com` (the document declares no server; this is the origin it was published from)
- URL: `https://api.ruzora.com/api/nps/stats`
- Auth: HTTP bearer

Get overall NPS statistics

**Query Parameters:**
- `days`: Number of days to analyze (default: 90)

**Returns:**
- Overall NPS score (-100 to 100)
- Promoter/Passive/Detractor counts and percentages
- Response rate
- Average score

**Example:**
```
GET /api/nps/stats?days=30
```

## Query parameters

- `days` integer

## Response `200`

Successful Response

- NPSStats: NPS statistics and analytics
  - `overall_nps` number, required: NPS score (-100 to 100)
  - `total_responses` integer, required
  - `promoters` integer, required: Count of 9-10 scores
  - `passives` integer, required: Count of 7-8 scores
  - `detractors` integer, required: Count of 0-6 scores
  - `promoter_percentage` number, required
  - `passive_percentage` number, required
  - `detractor_percentage` number, required
  - `response_rate` number, nullable: % of surveys sent that got responses
  - `average_score` number, required

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/ruzora/apis/ruzora-candidate-crm-api.md) · [All operations](https://skmtc.dev/ruzora/apis/ruzora-candidate-crm-api/llms.txt) · [OpenAPI document](https://skmtc.dev/ruzora/apis/ruzora-candidate-crm-api/revisions/f9b8223f3ac4?raw)