https://demo.notifuse.com/api/contacts.getByEmail Retrieves a contact by their email address within a specific workspace. The response always includes the contact's list subscriptions with their status (active, pending, unsubscribed, bounced, complained).
Authorizations
Bearer authentication header of the form Bearer <token>, where <token> is your API key.
Query Parameters
The ID of the workspace
The email address of the contact
Response
200 Contact found successfully object
Show 42 child attributes Hide 42 child attributes
Email address of the contact. This is the contact's unique identifier.
Identifier for the contact in your own system. Not unique — several contacts may share the same external_id.
Timezone of the contact
Preferred language of the contact
First name of the contact
Last name of the contact
Full name of the contact (for systems that don't have separate first/last names)
Phone number of the contact
First line of address
Second line of address
Country of the contact
Postal code
State or province
Job title of the contact
The contact's own choice about open tracking; null means unknown.
The contact's own choice about click tracking; null means unknown.
When a tracking choice last changed.
Where the last tracking choice came from (api, console, import, notification_center, email_link, subscribe_form).
Custom string field 1
Custom string field 2
Custom string field 3
Custom string field 4
Custom string field 5
Custom number field 1
Custom number field 2
Custom number field 3
Custom number field 4
Custom number field 5
Custom datetime field 1
Custom datetime field 2
Custom datetime field 3
Custom datetime field 4
Custom datetime field 5
Custom JSON field 1. Any JSON value, or null.
Custom JSON field 2. Any JSON value, or null.
Custom JSON field 3. Any JSON value, or null.
Custom JSON field 4. Any JSON value, or null.
Custom JSON field 5. Any JSON value, or null.
When the contact was created (read-only, set by server)
When the contact was last updated (read-only, set by server)
Lists the contact is subscribed to (read-only, included in GET responses only)
Show 7 child attributes Hide 7 child attributes
Email address of the contact
ID of the list
Name of the list
Subscription status
When the contact was subscribed to this list
When the subscription was last updated
When the subscription was deleted (null if active)
Segments the contact belongs to (read-only, included in GET responses only)
Show 5 child attributes Hide 5 child attributes
Email address of the contact
ID of the segment
Version of the segment computation
When the contact was matched to this segment
When the segment was last computed
400 Bad request - missing parameters object
Error message
401 Unauthorized - invalid or missing authentication token object
Error message
404 Contact not found object
Error message
500 Internal server error object
Error message