ListMembers

Individuals who are currently or have been previously suscribed to this list, including members who have bounced or unsubscribed.

Table Specific Information

SELECT, INSERT, UPDATE, and DELETE are supported for ListMembers.

Select

A ListId is required to retrieve data from this table. If none is specified in the WHERE clause, the first one available for your account will be used.

Insert

The ListId, EmailAddress, and Status are required for INSERTs.\

INSERT INTO ListMembers (ListId, EmailAddress, Status) VALUES ('myListId', 'myEmailAddress', 'subscribed')

Columns

Name	Type	ReadOnly	Description
Id [KEY]	String	True	The MD5 hash of the list member's email address.
EmailAddress	String	False	Email address for a subscriber.
UniqueEmailId [KEY]	String	True	An identifier for the address across all of MailChimp.
EmailType	String	False	Type of email this member asked to get ('html' or 'text').
FullName	String	False	The contact's full name.
Status	String	False	Subscriber's current status ('subscribed', 'unsubscribed', 'cleaned', 'pending' or 'transactional'). The allowed values are subscribed, unsubscribed, cleaned, prending, transactional.
StatusIfNew	String	False	Subscriber's status ('subscribed', 'unsubscribed', 'cleaned', or 'pending'), to be used only on a PUT request if the email is not already present on the list.
Interests	String	False	The key of this object's properties is the ID of the interest in question.
Stats_AvgOpenRate	Double	True	A subscriber's average open rate.
Stats_AvgClickRate	Double	True	A subscriber's average clickthrough rate.
IpSignup	String	True	IP address the subscriber signed up from.
TimestampSignup	Datetime	True	Date and time the subscriber signed up for the list.
IpOpt	String	True	IP address the subscriber confirmed their opt-in status.
TimestampOpt	Datetime	True	Date and time the subscribe confirmed their opt-in status.
MemberRating	Integer	True	Star rating for this member between 1 and 5.
LastChanged	Datetime	True	Date and time the member's info was last changed.
Language	String	False	If set/detected, the language of the subscriber.
Vip	Boolean	False	VIP status for subscriber.
EmailClient	String	True	The email client the address as using.
Location_Latitude	Double	False
Location_Longitude	Double	False
Location_Gmtoff	Integer	True
Location_Dstoff	Integer	True
Location_CountryCode	String	True
Location_Timezone	String	True
LastNote_NoteId	Integer	False	The note's ID.
LastNote_CreatedAt	String	False	The date the note was created.
LastNote_CreatedBy	String	False	The author of the note.
LastNote_Note	String	False	The content of the note.
ListId [KEY]	String	False	The id for the list.
TagsAggregate	String	True	Tags of the member, displayed as an aggregate.