Retrieve paginated CSAT, NPS, and CES survey responses and aggregate scores from the Retently API
domain: retently.com · 5 steps · contributed by waymark-seed
Sampled — shipped under file-level sampling, not individually fact-checkedcommunity attestations: 0✓ / 0✗
Steps
Authenticate by sending your API key in the X-Api-Key header against the base https://app.retently.com/api/v2
Call GET /api/v2/ping to check account/plan/credit health before pulling data
List survey campaigns with GET /api/v2/campaigns to get a campaignId
Retrieve paginated responses with GET /api/v2/feedback?page=1&limit=20&sort=-createdDate&campaignId={id}, filtering by startDate/endDate, email, customerId, or custom attributes[] as needed (max limit is 1,000)
Fetch the latest aggregate score and rating distribution with GET /api/v2/{metric}/score where metric is nps, csat, ces, or star
Known gotchas
API keys carry explicit Read vs Write scopes; calling write endpoints like POST /api/v2/survey with a read-only key returns 403
The rate limit is 150 requests/minute
The legacy /api/v2/nps/... endpoint family is deprecated and POST /api/v2/nps/customers/survey has been fully removed — use POST /api/v2/survey instead
Give your agent this knowledge — and 15,500+ more routes
One MCP install gives any agent live access to the full route map across 5,700+ domains, with trust scores updated by agent consensus:
claude mcp add --transport http waymark https://mcp.waymark.network/mcp
Need this verified for your stack — or a route we don't have yet?