SurveyResponse

Get Survey from SurveyResponse

Changed on
get/SurveyResponse({Id})/Survey

Request

  • Base URL: https://marketingpony.us1app.churnzero.net/public/v1
  • URL: https://marketingpony.us1app.churnzero.net/public/v1/SurveyResponse({Id})/Survey
  • Auth: HTTP basic

Path parameters

Idnumber nullable required

Id of the SurveyResponse

Query parameters

$selectstring[]

Select properties to be returned

$expandstring[]

Expand related entities

Response

Retrieved navigation property

Idnumber

Internal identifier for ChurnZero.

CampaignStatusstring

The lifecycle status of the survey: Draft, Paused, Running, Complete, or Archived. Running surveys are actively sending (shown as Active in the ChurnZero UI).

CampaignTypestring

How the survey dispatches: Periodic (recurring on a schedule), OnSegmentEntry (sends when a Contact or record enters a targeted Segment), External (responses collected outside ChurnZero and synced in), or Imported (historical responses imported from another platform).

DripOverMonthsnumber

The drip rate for a Periodic survey: the number of months (1, 3, or 6) the send is spread over, surveying a portion of the target population each day instead of sending to everyone at once. 0 means the survey sends to everyone at once.

FollowActiveHoursboolean

Whether a segment-entry send is held until the account's active hours. When false the send goes out at the moment it is triggered. Only meaningful when SendBasedOn is "Segment entry" — scheduled-time surveys always report false.

IsActiveboolean

Whether the survey is actively processing recipients. When set to false the survey pauses in place: no new recipients enter and no further sends or reminders go out until it is reactivated.

Namestring

The name of the survey, shown on the Surveys page in ChurnZero.

RecurringEveryMonthsnumber

For Periodic surveys, the recurrence interval in months: how long after a recipient's previous survey they are surveyed again (e.g. 6 = re-surveyed six months later). 0 means a one-time survey.

SegmentIdsnumber[]

The Ids of the Segments that define the survey's audience. Membership in any one of the listed Segments qualifies a recipient (OR logic).

SendBasedOnstring

What triggers the send: "A scheduled time" (the survey fires at its configured SendTime) or "Segment entry" (the survey fires when a recipient enters the targeted Segment).

SendDayTypestring

Which days the survey may send on: Business (weekdays only) or Calendar (any day).

SendTimestring time

The clock time the survey is configured to send, in the survey's SendTimeZone (e.g. 09:30:00). Null when no send hour is set. Supports $select and $filter (including the range operators); sorting is not available on this property, because it is computed from the stored hour and minute rather than held as a single column.

SendTimeZonestring

The time zone the survey's send time is expressed in, as an IANA time zone id (e.g. "America/New_York", "Etc/UTC"). Supports $select and $filter; filter with 'eq' and a full IANA id — the substring functions are not available, and sorting is not available on this property.

SendToExistingSegmentMembersboolean

For a segment-entry survey, whether recipients already in the targeted Segment when the survey was activated are surveyed, rather than only those who enter afterwards.

SurveyQuestionstring

The text of the survey's primary question shown to recipients (e.g. the NPS question "How likely is it that you would recommend ... ?").

SurveyTypestring

The type of the survey: NPS (loyalty, scored 0-10), CSAT (satisfaction), CES (effort, 1-7 scale), or Custom (multi-question survey; see the SurveyQuestion entity for its questions).

Example response

{
  "FollowUpQuestions": [
    {
      "Question": "What is the primary reason for your score?",
      "AnswerType": "Text"
    }
  ],
  "Settings": {
    "ChoiceCount": 10,
    "AnswerType": "Number"
  }
}

Changes

    • info

      added the enum value FollowActiveHours to the property items/ of the query request parameter $select

    • info

      added the enum value SendBasedOn to the property items/ of the query request parameter $select

    • info

      added the enum value SendDayType to the property items/ of the query request parameter $select

    • info

      added the enum value SendTime to the property items/ of the query request parameter $select

    • info

      added the enum value SendTimeZone to the property items/ of the query request parameter $select

    • info

      added the enum value SendToExistingSegmentMembers to the property items/ of the query request parameter $select

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status