NewsMAN API: subscriber.get

Sections

Newsman – Knowledge Base

HomeAPISubscribersubscriber.get

Newsman Api Method: subscriber.get

Prototype: subscriber.get(subscriber_id)

Description: Returns subscriber data as hash (struct) array

HTTP method: GET

Endpoint HTTP: /subscriber.get.json

Endpoint XML-RPC: subscriber.get

Return type: struct

Return info: Hash array with subscriber details:
subscriber_id
email
status: any of subscribed, unsubscribed, bounced, spam, inactivated
subscribe_date: present if subscribed
unsubscribe_date: present if unsubscribed
bounce_date: present if bounced
spam_date: present if spam complaint received
firstname
lastname
ip
props: hash array with props stored for this subscriber

Request parameters GET

Variable	Type	Description
subscriber_id	string\|int	The ID of the subscriber for which to get the data

Response parameters

Parameter	Description
list_id	The ID of the list of the subscriber
subscriber_id	The ID of the subscriber
email	The email of the subscriber
status	The status: any of subscribed, unsubscribed, bounced, spam, inactivated
subscribe_date	The date of subscription. Present if subscribed.
unsubscribe_date	The date of unsubscription. Present if unsubscribed.
bounce_date	The date of the bounce. Present if bounced.
spam_date	The date of the spam report. Present if spam complaint received
firstname	The firstname of the subscriber
lastname	The lastname of the subscriber
ip	The ip of the subsscription
props	Hash array with props stored for this subscriber
segments	Hash array with the segments that includ this subscriber

Output example

{
    "list_id": "my_list_id",
    "subscriber_id": 75001,
    "email": "test@example.com",
    "status": "subscribed",
    "subscription_type": "import",
    "subscribe_date": "2018-05-13 17:02:32",
    "firstname": null,
    "lastname": null,
    "ip": "127.0.0.1",
    "props": [],
    "segments": [
        {
            "segment_id": 15002,
            "name": "my_segment_name"
        }
    ]
}

Response Errors

Code	Message	Description
407	Missing required param subscriber_id	subscriber_id param is required
101	Not allowed for list_id = %s	Invalid access to subscriber list_id
108	List %s has been deleted	Subscriber ID belongs to a list which has been deleted
129	Not allowed for subscriber with ID: %s	Invalid access to subscriber id
121	Could not load subscriber	The subscriber was not found

Error examples

{
    "err": true,
    "message": "Missing required param subscriber_id",
    "code": 407
}

{
    "err": true,
    "message": "Not allowed for subscriber with ID: 752981",
    "code": 129
}