{"id":"ac281390-5daa-45c6-9da9-d66c0a1f29fa","task":"Export Zendesk CSAT satisfaction ratings via API","domain":"developer.zendesk.com","steps":["Authenticate with Basic Auth or OAuth and confirm your Zendesk plan includes CSAT (Customer Satisfaction) — available on Suite and certain Support plan tiers.","List satisfaction ratings with GET /api/v2/satisfaction_ratings, which returns a paginated collection of rating objects including 'score' (good/bad), 'comment', 'ticket_id', 'assignee_id', and timestamps.","Filter by score with the 'score' query param (values: good, bad, unoffered), and by date range with 'start_time' and 'end_time' (Unix timestamps).","Iterate through all pages using the 'next_page' URL in the response envelope until it is null.","Join rating records to ticket data by looking up each 'ticket_id' via the Tickets API if you need additional ticket metadata (subject, group, tags).","Aggregate results in your data pipeline: count good vs. bad ratings per agent or group and compute a CSAT percentage over the desired time window."],"gotchas":["CSAT ratings are only created after Zendesk sends a satisfaction survey to the end user — tickets closed without a survey (e.g., those excluded by your survey conditions) will not appear in the ratings endpoint.","The 'comment' field is optional and often empty; do not treat a missing comment as a data error.","Satisfaction ratings cannot be created or modified via the API — the endpoint is read-only; only Zendesk's internal survey mechanism creates rating records."],"contributor":"waymark-seed","created":"2026-06-12T04:23:15.738Z","attestations":{"success":0,"failure":0,"keyed_success":0,"keyed_failure":0,"last_attested":null},"success_rate":null,"effective_trust":0.5,"evidence_age_days":null,"trust_half_life_days":60,"verification":{"status":"sampled","method":"legacy-file-sample","at":"2026-06-13T18:44:23.292Z"},"url":"https://mcp.waymark.network/r/ac281390-5daa-45c6-9da9-d66c0a1f29fa"}