get https://api.mailerlite.com/api/v2/subscribers/
Get single subscriber [Rate limited]
Response Body Parameters
Parameter | Type | Description |
---|---|---|
id | integer | ID of a subscriber |
email | string | Email address |
name | string | Name of a subscriber |
sent | integer | Count of emails sent to subscriber |
opened | integer | Count of emails opened by subscriber |
clicked | integer | Count of clicks made by subscriber |
type | string | Available values: - active - bounced - unsubscribed - junk - unconfirmed |
signup_ip | string | IPv4 or IPv6 address indicating the subscriber's signup |
signup_timestamp | string | UTC in format Y-m-d H:i:s |
confirmation_ip | string | IPv4 or IPv6 address indicating the subscriber's opt-in |
confirmation_timestamp | string | UTC in format Y-m-d H:i:s |
fields | array of objects Subscriber's Field Value | Array which contains default and custom fields. |
date_subscribe | string | Important only when getting Subscribers in a Group. It shows when subscriber is added to group. Date format: Y-m-d Default value: null . |
date_unsubscribe | string | Important only when getting Subscribers in a Group. It shows when subscriber's status changed to unsubscribed .Date format: Y-m-d H:i:s Default value: null . |
date_created | string | Date when subscriber is created Format: Y-m-d H:i:s |
date_updated | string | Datetime when subscriber is updated: Format: Y-m-d H:i:s |
Signup & Confirmation fields
signup_ip
signup_timestamp
confirmation_ip
confirmation_timestamp
Those fields are filled automatically using our built-in webforms.
When double opt-in is enabled and subscriber signs up, we fill only
signup_*
fields. After subscriber's confirmation,confirmation_*
fields are updated too.When double opt-in is disabled, all the fields are filled with the same data because sign up and confirmation is performed as a single action.
Subscriber profile image
We use Gravatar profile images for subscriber profile in web application. The image below is used as default.