Get Survey Contact
Returns detailed information about a specific contact within a survey campaign.
Endpoint
GET
v5/survey/{survey_id}/surveycampaign/{campaign_id}/surveycontact/{contact_id}
Requires authentication
Path Parameters
Identifies the survey, campaign, and specific contact to retrieve.
survey_id
string
required
The ID of the survey.
campaign_id
string
required
The ID of the survey campaign.
contact_id
string
required
The ID of the contact to retrieve.
Query Parameters
This endpoint does not accept additional query parameters beyond authentication credentials.
None
Response
Returns a single contact object. Includes all standard contact fields plus an invitelink field containing the contact's unique respondent URL. See List Survey Contacts for the full list of contact fields.
result_ok
boolean
Whether the request succeeded.
data
object
The contact object.
child attributes
id
integer
The unique ID of the contact.
email_address
string
The contact's email address.
invitelink
string
The unique respondent URL generated for this contact. Only returned on the GET single contact endpoint.
status
string
The contact's status. Possible values:
Active, Inactive.subscriber_status
string
A combination of status log response status and send status. Possible values:
Unsent, Sent, Bounced, Partial (link clicked and at least one page submitted), Complete (link clicked and response completed).date_last_sent
string
Timestamp of when the campaign email was last sent to this contact. Empty string if never sent.
Examples
Note GET requests are cached for 60 seconds. Repeated identical requests within that window will return cached results.
Request (cURL)
curl -X GET "https://api.alchemer.com/v5/survey/123456/surveycampaign/100000/surveycontact/100039753?api_token=YOUR_API_TOKEN&api_token_secret=YOUR_API_TOKEN_SECRET"
Response
{
"result_ok": true,
"data": {
"id": 100039753,
"email_address": "jon.doe@alchemer.com",
"first_name": "Jon",
"last_name": "Doe",
"organization": "",
"title": "Manager",
"customfield1": "",
"invitelink": "http://s-123-i.sgizmo.com/s3/abcdefg",
"status": "Active",
"subscriber_status": "Unsent",
"date_last_sent": ""
}
}