ContactFilterInput

Input Object

accountId

Account ID that owns this contact

addressCountry

Country based on IP address geolocation

addressLocality

City or locality based on IP address geolocation

addressRegion

State, province, or region based on IP address geolocation

and

audienceId

campaignsSentLast30Days

Number of campaigns sent to this contact in the last 30 days

churnRisk

Score (0-100) indicating risk of this contact churning

confirmedIp

IP address from which the contact confirmed their subscription

confirmedUtc

Date/time when the contact confirmed their subscription (UTC)

contentAffinityScore

Score (0-100) indicating affinity for specific content types

createdBy

User or system that created the contact record

createdUtc

Date/time when the contact record was created (UTC)

daysInCurrentStage

Number of days the contact has been in their current lifecycle stage

daysSinceLastEngagement

Number of days since the contact last engaged with a campaign

daysSinceLastSent

Number of days since a campaign was last sent to this contact

daysSincePeakEngagement

Number of days since the contact was at their peak engagement

email

Complete email address of the contact

engageStatLastUpdateUtc

Date/time when engagement statistics were last updated (UTC)

engagementLevel

Engagement level tier (0-3) derived from the engagement score (0=Inactive (only for established contacts), 1=Cold (includes onboarding contacts), 2=Warm, 3=Hot)

engagementLifecycleStage

Current lifecycle stage (0=new, 1=active, 2=at-risk, 3=dormant, 4=lost, 5=Reactivated)

engagementScore

Overall engagement score from 0-100 based on email interaction history

engagementScoreCalculatedUtc

Date/time when engagement score was last calculated

engagementScoreChange

Change in engagement score since last calculation (can be negative)

engagementScoreNeedsRecalc

Flag indicating if the engagement score needs recalculation

engagementTrendIndicator

Trend indicator showing engagement trajectory (-1=declining, 0=stable, 1=improving)

firstName

First name of the contact

hardBounceCount

Consecutive hard bounces received (resets to 0 after successful delivery)

id

Unique identifier for the contact

journeyLast5Bounced

Count of bounces from up to the five most recent journey emails for this contact

journeyLast5Clicked

Count of clicks from up to the five most recent journey emails for this contact

journeyLast5Count

Number of journey emails included in the JourneyLast5 counters (0-5)

journeyLast5Delivered

Count of deliveries from up to the five most recent journey emails for this contact

journeyLast5Forward

Count of forwards from up to the five most recent journey emails for this contact

journeyLast5Opened

Count of opens from up to the five most recent journey emails for this contact

journeyLast5Replied

Count of replies from up to the five most recent journey emails for this contact

journeyLast5Shared

Count of social shares from up to the five most recent journey emails for this contact

journeyLastBounced

Date/time of last journey email bounce

journeyLastClicked

Date/time of last journey email link click

journeyLastDelivered

Date/time of last journey email delivery

journeyLastForward

Date/time of last journey email forwarded to a friend

journeyLastOpened

Date/time of last journey email opened

journeyLastReplied

Date/time of last journey email reply

journeyLastShared

Date/time of last journey email shared on social media

language

Preferred language code (e.g., en-US)

last5Bounced

Represents the count of up to the five most recently bounced campaigns for this contact. (If fewer than five campaigns have been sent—e.g., for new accounts—only the available campaigns are included.)

last5Clicked

Represents the count of up to the five most recent campaigns for this contact with link click events. (If fewer than five campaigns have been sent—e.g., for new accounts—only the available campaigns are included.)

last5Count

Represents the count of up to the five most recent campaigns for this contact. (If fewer than five campaigns have been sent—e.g., for new accounts—only the available campaigns are included.)

last5Delivered

Represents the count of up to the five most recently delivered campaigns for this contact. (If fewer than five campaigns have been sent—e.g., for new accounts—only the available campaigns are included.)

last5Forward

Represents the count of up to the five most recent campaigns for this contact with Forward-to-friend events. (If fewer than five campaigns have been sent—e.g., for new accounts—only the available campaigns are included.)

last5Opened

Represents the count of up to the five most recent campaigns for this contact with open events. (If fewer than five campaigns have been sent—e.g., for new accounts—only the available campaigns are included.)

last5Replied

Represents the count of up to the five most recent campaigns for this contact with reply events. (If fewer than five campaigns have been sent—e.g., for new accounts—only the available campaigns are included.)

last5Shared

Represents the count of up to the five most recent campaigns for this contact with social share events. (If fewer than five campaigns have been sent—e.g., for new accounts—only the available campaigns are included.)

lastBounced

Date/time of last campaign bounce

lastClicked

Date/time of last campaign link click

lastDelivered

Date/time of last campaign delivery

lastForward

Date/time of last campaign forwarded to a friend

lastName

Last name of the contact

lastOpened

Date/time of last campaign opened

lastReplied

Date/time of last campaign reply

lastShared

Date/time of last campaign shared on social media

latitude

Latitude coordinate based on IP address geolocation

listFatigueScore

Score indicating potential fatigue from receiving too many campaigns (0=no fatigue, 100=high fatigue)

longitude

Longitude coordinate based on IP address geolocation

modifiedBy

User or system that last modified the contact record

modifiedUtc

Date/time when the contact record was last modified (UTC)

mostRecentCampaignId

Campaign ID of the most recent campaign event

mostRecentCampaignName

Campaign name of the most recent campaign event

mostRecentClickUrl

URL that was clicked in the most recent click event

mostRecentEventAtUtc

Date/time of the most recent campaign event (UTC)

mostRecentEventType

Type of the most recent campaign event (0=Delivered, 1=Opened, 2=Clicked, 3=Bounced, etc.)

mostRecentIsJourney

Indicates whether the most recent event was from a journey email

mostRecentJourneyId

Journey ID if the most recent event was from a journey email

mostRecentJourneyName

Journey name if the most recent event was from a journey email

mostRecentSubject

Email subject line of the most recent campaign event

optInIp

IP address from which the contact opted in

optInSource

Method by which the contact opted in (Form, Import, API, etc.)

optInUtc

Date/time when the contact opted in to receive emails (UTC)

optOutIp

IP address from which the contact unsubscribed

optOutReason

Reason provided by the contact for unsubscribing

optOutSource

Method by which the contact unsubscribed

optOutUtc

Date/time when the contact unsubscribed (UTC)

optimalSendFrequency

Recommended number of campaigns per week for this contact (0=None, 1=Weekly, 2=2-3x per week, 3=Daily)

or

peakEngagementDateUtc

Date/time when the contact achieved their peak engagement score

peakEngagementScore

Highest engagement score ever achieved by this contact

postalCode

Postal or ZIP code based on IP address geolocation

primaryEngagementType

Primary type of engagement (0=None, 1=Opens, 2=Clicks, 3=Replies, 4=Shares)

profileFields

rating

Custom rating value for the contact (0-50)

reengagementPriority

Priority level for re-engagement campaigns (0=low, 1=medium, 2=high, 3=urgent)

reengagementProbability

Probability score (0-100) of successfully re-engaging this contact

segmentationCalculatedUtc

Date/time when segmentation metadata was last calculated

sendFormat

Preferred email format (HTML, Plain Text, or Multipart)

sendRecommendation

Recommendation for including in next campaign (0=exclude, 1=Never (worse then a caution), 2=Include, 3=Priority)

softBounceCount

Consecutive soft bounces received (resets to 0 after successful delivery)

status

Current subscription status (Subscribed, Unsubscribed, Undeliverable, etc.)

streetAddress

Primary street address line

streetAddress2

Secondary street address line (apartment, suite, etc.)

tagList

timeZone

IANA time zone identifier (e.g., America/New_York)

unsubscribeRisk

Score (0-100) indicating risk of this contact unsubscribing