A valid request URL is required to generate request examples{
"surveys": [
{
"id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"kind": "nps",
"question": "<string>",
"delivered_at": "2023-11-07T05:31:56Z"
}
]
}{
"error": {
"code": "forbidden",
"message": "your role does not allow this action"
}
}{
"error": {
"code": "forbidden",
"message": "your role does not allow this action"
}
}{
"error": {
"code": "forbidden",
"message": "your role does not allow this action"
}
}My outstanding surveys
What the widget asks on a page load: is there a question outstanding for this person, oldest first.
Delivery is decided by the API rather than by the page — a trigger fired, the audience matched, and the per-contact cooldown was open — so this read is the whole of the client’s side. There is no way to ask for a survey.
Two things bound what comes back. A delivery older than 14 days is no longer pending: a question nobody answered in two weeks is not one they still owe an answer to, and a widget that opens a survey from March is one people learn to dismiss without reading. And a survey switched off stops being pending for the people it had already reached, not just for the ones it had not.
An anonymous session answers an empty list rather than a refusal, and by meaning rather than by a special case: a survey is only ever delivered to an identified contact, so a visitor has nothing outstanding.
It needs a verified session, and the reason is the targeting: whether somebody was asked at all depends on segment membership, so “does this external_id have the churn survey” would be “is this person in the at-risk segment”, asked by anybody who knows an id.
A valid request URL is required to generate request examples{
"surveys": [
{
"id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"kind": "nps",
"question": "<string>",
"delivered_at": "2023-11-07T05:31:56Z"
}
]
}{
"error": {
"code": "forbidden",
"message": "your role does not allow this action"
}
}{
"error": {
"code": "forbidden",
"message": "your role does not allow this action"
}
}{
"error": {
"code": "forbidden",
"message": "your role does not allow this action"
}
}