Need help with your APIs? I offer API discovery, governance & evangelism services. Explore services →
API Evangelist API Evangelist
Discovery
Learnings
Guidance
Toolbox
Alignment
API Evangelist LLC

Wootric Responses API

Manage NPS/CSAT/CES survey responses

Wootric Responses API is one of 8 APIs that Wootric publishes on the APIs.io network, described by a machine-readable OpenAPI specification.

Tagged areas include Responses. The published artifact set on APIs.io includes an OpenAPI specification and API documentation.

This API exposes 9 operations across 7 paths, and defines 5 schemas. It is described by OpenAPI 3.0.3, at version 1.0.0.

Requests are made against 3 base URLs: https://api.wootric.com, https://api.eu.wootric.com, https://api.au.wootric.com.

9 operations 7 paths 5 schemas 1 DELETE6 GET1 POST1 PUT

Metadata

The identity and technical contract details declared by the specification.

Specification
OpenAPI 3.0.3
API Version
1.0.0
Base URL
https://api.wootric.com
Authentication
HTTP Bearer
Resource Areas
1

Authentication & Security 1

Wootric Responses API declares 1 security scheme for authenticating requests. It accepts HTTP bearer tokens (BearerAuth). By default, every request must be authenticated.

  • BearerAuth — OAuth 2.0 Bearer token. Obtain via password, clientcredentials, or refreshtoken grant. Tokens expire after 2 hours.

Paths & Operations 9

Across 7 paths, the API surfaces 9 operations — 1 DELETE, 6 GET, 1 POST, 1 PUT. Each is listed below with its method, path, parameters, and response codes.

Responses 9

Manage NPS/CSAT/CES survey responses

GET
/v1/responses
Get all responses
listResponses 7 params → 200401
PUT
/v1/responses/{id}
Update a response
updateResponse 1 param body → 204400401404
GET
/v1/end_users/{end_user_id}/responses
Get all responses for an end user
listEndUserResponses 8 params → 200401404
POST
/v1/end_users/{end_user_id}/responses
Create a response for an end user
createResponse 1 param body → 200400401
GET
/v1/end_users/{end_user_id}/responses/{id}
Get a specific response for an end user
getEndUserResponse 2 params → 200401404
DELETE
/v1/end_users/{end_user_id}/responses/{id}
Delete a response
deleteResponse 2 params → 204401404
GET
/v1/end_users/{end_user_id}/responses/promoters
Get promoter responses for an end user (scores 9-10)
listPromoterResponses 5 params → 200401
GET
/v1/end_users/{end_user_id}/responses/passives
Get passive responses for an end user (scores 7-8)
listPassiveResponses 5 params → 200401
GET
/v1/end_users/{end_user_id}/responses/detractors
Get detractor responses for an end user (scores 0-6)
listDetractorResponses 5 params → 200401

Schemas 5

The contract defines 5 schemas that model the data the API accepts and returns. The most detailed are SurveyResponse (10 properties), EndUser (9 properties), ResponseInput (6 properties), ResponseUpdateInput (3 properties). Each schema is shown below with its type and property counts.

ResponseInput
object
6 properties 1 required
EndUser
object
9 properties
ResponseUpdateInput
object
3 properties
Error
object
2 properties
SurveyResponse
object
10 properties

Specification

The full machine-readable OpenAPI contract behind this narrative.

Source

wootric-responses-api-openapi.yml Raw ↑

Other APIs Wootric publishes across the network.

Wootric Declines API
Wootric Email Surveys API
Wootric End Users API
Wootric Metrics API
Wootric Segments API
Wootric Settings API
Wootric Survey Templates API