Skip to main content
TroopyDocs
GuidesSet up and use TroopyAppsConnect your servicesAPIThe API, the CLI and MCPChangelogEach update to Troopy

Developers

Account

Troop

Skills

Tasks and projects

Needs you

Routines and triggers

Brain

Docs

Canvas

Email

CRM

Outreach

Customers

Analytics

Sessions

Surveys

Support Agent

Tests and incidents

Disputes

Apps

Vault

Computer

Open Troopy
Troopy

API reference / Surveys

List the surveys

The surveys of the workspace, the newest first. A survey asks the users of the product of the business some questions, in a card on the pages of the product. One survey shows at a time. Each survey says how many customers saw it and answered it, and its score when it asks the question of the score.

get/api/v1/surveys

Authorization

HeaderAuthorization: Bearer <API key>
Or the headerX-API-Key: <API key>
API keyMake one in Troopy under Settings > API keys. It acts as you, in its workspace.
Scopescustomers:read

Other ways to call it

CLItroopy surveys list
MCP tooltroopy_list_surveys
Rate limit120 calls in 60 seconds, for each key

Response

200 · application/json
data*array<object>
14 properties
id*string

A 24-character id

name*string

The name of the survey, for the people of the business. Customers never see it

active*boolean

The survey shows in the product now. One survey of a workspace shows at a time

scored*boolean

The survey asks how a customer would feel without the product. The score comes from this question, and its words are fixed

questions*array<object>

The open questions, in the order that the survey asks them, after the question of the score. A customer can skip each one

2 properties
id*string
text*string

The question, in the words of the business

audience*enum<string>

engaged: the users who know the product, 7 days after they began, with steady use or 3 days of use in the last 30. everyone: each user

engagedeveryone

again*integer | null

After how many days a customer gets the survey again. Null: a customer answers it one time

shown*integer

The customers who saw the survey

answered*integer

The customers who answered it

lastAnswerAt*string | null

When a customer last answered it

score*object | null

The score of this survey, each customer with its latest answer to it. Null when it does not ask that question

8 properties
answers*integer

The answers that count: each answer but no_longer_use

very*integer

Would be very disappointed without the product

somewhat*integer

Would be somewhat disappointed

not*integer

Would not be disappointed

gone*integer

No longer use the product. These are not in the score

love*number | null

The share that would be very disappointed, in percent. Null under 5 answers

low*number | null

The low end of the 95% range of that share, in percent. Null under 10 answers

level*enum<string>

hidden: under 5 answers, so no share. directional: 5 to 9 answers. ranked: 10 or more

hiddendirectionalranked

by*object

Who made it

2 properties
type*string
name*string | null
activatedAt*string | null

When the survey last began to show

createdAt*string

ISO 8601 date and time

Errors

401 unauthorizedSend an API key as `Authorization: Bearer tr_live_...`. Create one in Troopy under Settings.
403 forbiddenThe key lacks a scope this operation needs, or its owner lacks the role. detail says which; create a key with the scope, or ask an organization owner or admin.
429 rate_limitedWait the number of seconds in Retry-After, then retry.