Results summary · Cueston Docs

GET/surveys/{id}/responses/summaryNeedsanalytics.view

Totals, NPS (% promoters − % detractors, −100…100), a weekly trend and per-question results.

Authorization

secretKey

headerAuthorizationBearer <sk_…>

A secret API key from Settings → API keys. It acts with its creator's role.

Path Parameters

id*integer

The survey's id.

Range1 <= value

Query Parameters

days?integer

Time window in days.

Default30

Value in73090

environment?string

Which environment's responses.

Default"production"

Value in"production""staging"

Response Body

application/json

response

survey*

summary*

Shell

curl -X GET 'https://app.cueston.com/api/surveys/1/responses/summary'

Example ResponseSchema

JSON

{
  "survey": {
    "id": 42,
    "name": "Quarterly NPS"
  },
  "summary": {
    "range": {
      "from": "2026-10-26T09:30:00Z",
      "to": "2026-10-26T09:30:00Z"
    },
    "environment": "production",
    "totals": {
      "impressions": 1840,
      "viewers": 0,
      "responses": 0,
      "completed": 0,
      "partial": 0,
      "responseRate": 0
    },
    "nps": {
      "questionId": "string",
      "score": 0,
      "promoters": 0,
      "passives": 0,
      "detractors": 0,
      "total": 3
    },
    "trend": [
      {}
    ],
    "questions": [
      {}
    ]
  }
}{
  "survey": {
    "id": 42,
    "name": "Quarterly NPS"
  },
  "summary": {
    "range": {
      "from": "2026-10-26T09:30:00Z",
      "to": "2026-10-26T09:30:00Z"
    },
    "environment": "production",
    "totals": {
      "impressions": 1840,
      "viewers": 0,
      "responses": 0,
      "completed": 0,
      "partial": 0,
      "responseRate": 0
    },
    "nps": {
      "questionId": "string",
      "score": 0,
      "promoters": 0,
      "passives": 0,
      "detractors": 0,
      "total": 3
    },
    "trend": [
      {}
    ],
    "questions": [
      {}
    ]
  }
}