Get Email Message
Returns detailed information about a specific email message within a survey campaign.
Endpoint
GET
v5/survey/{survey_id}/surveycampaign/{campaign_id}/emailmessage/{message_id}
Requires authentication
Path Parameters
Identifies the survey, campaign, and specific message to retrieve.
survey_id
string
required
The ID of the survey.
campaign_id
string
required
The ID of the survey campaign.
message_id
string
required
The ID of the email message to retrieve.
Query Parameters
This endpoint does not accept additional query parameters beyond authentication credentials.
None
Response
Returns a single email message object.
result_ok
boolean
Whether the request succeeded.
data
object
The email message object.
child attributes
id
integer
The unique ID of the email message.
subtype
string
The message subtype. Possible values:
message, reminder.message_type
string
The format of the message. Possible values:
plaintext, html.medium
string
The delivery medium. Always
Email.invite_identity
integer
The internal ID of the campaign (invite identity) this message belongs to.
status
string
The current send status of the message (e.g.
Building, Sent).from
object
The sender details for the message.
child attributes
email
string
The sender's email address.
name
string
The sender's display name.
subject
string
The email subject line.
body
object
The message body content.
child attributes
text
string
The plaintext version of the message body.
html
string
The HTML version of the message body. Empty string if the message is plaintext only.
footer
string
The message footer text, typically including the physical address and unsubscribe link merge codes.
embed_question
boolean
Whether the first survey question is embedded in the email body.
disable_styles
boolean
Whether default email message styles are disabled.
date_created
string
Timestamp when the message was created.
date_modified
string
Timestamp when the message was last modified.
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/emailmessage/128073?api_token=YOUR_API_TOKEN&api_token_secret=YOUR_API_TOKEN_SECRET"
Response
{
"result_ok": true,
"data": {
"id": 128073,
"subtype": "message",
"message_type": "html",
"medium": "Email",
"invite_identity": 94135,
"status": "Building",
"from": {
"email": "surveys@sgizmo.com",
"name": "Survey Research"
},
"subject": "Please take our survey",
"body": {
"text": "Hi\nI'm currently running a study...\n\n[invite(\"survey link\")]\n\nThank You!",
"html": "Hi\n\nI'm currently running a study...\n\n[invite(\"html link\"), title=\"Begin\"]\n\nThank You!"
},
"footer": "This message was sent by [account(\"physical address\")].\nTo unsubscribe, click below:\n[invite(\"unsubscribe link\")]",
"embed_question": null,
"disable_styles": null,
"date_created": "2014-07-29 11:25:54",
"date_modified": "2016-05-24 14:53:33"
}
}