API - Contact View

Description:

View only one contact's details.

HTTP method:

GET

Supported output formats:

xml, json, serialize

Requires authentication:

true

Parameters:

* indicates requirement. Underlined params include in URL, otherwise as part of the post body. POST data must be formatted as 

Content-Type: application/x-www-form-urlencoded

. We don't accept any other input formats like JSON.

Variable	Description
account*	YOUR account url
api_action*	contact_view
api_key*	Your API key
api_output	xml, json, or serialize (default is XML)
id*	ID of the contact you want to view

Example response:

Variable	Description
id	ID of the contact. Example: 2
subscriberid	ID of the contact. Example: 2
listid	ID of the list this contact is part of. Example: 1
formid	Subscription form ID used when subscribing. Example: 0
sdate	Date subscribed. Example: 2011-03-09 09:59:12
udate	Date unsubscribed. Example: 2011-03-08 14:24:44
status	Status for this list. Example: 1
responder	1
sync	0
unsubreason	Unsubscribe reason.
unsubcampaignid	Campaign sent when unsubscribed. Example: 10
unsubmessageid	Message sent when unsubscribed. Example: 1
first_name	First name of contact. Example: Name
last_name	Last name of contact. Example: One
orgid	ID of the contact's organization. Example: 1
orgname	Name of the contact's organization. Example: ACME, Inc.
cdate	Date subscribed. Example: 2011-03-02 14:47:01
email	Email address of contact. Example: [e-mail]
bounced_hard	Number of times this contact has hard-bounced. Example: 0
bounced_soft	Number of times this contact has soft-bounced. Example: 0
bounced_date	Date of most recent bounce for this contact.
ip	IP address of the contact. Example: 38.104.242.98
hash	Unique hash for the contact. Example: dfdsfdsfefr345345wfdrs3r
socialdata_lastcheck	Last time social data was fetched for this contact.
lid	1
name	Full name of this contact. Example: Name One
a_unsub_date	2011-03-08
a_unsub_time	14:24:44
lists	Array
listslist	String of lists for this contact. Example: 1
fields	Array
actions	Array
bounces	Array
bouncescnt	Number of total bounces for this contact. Example: 0
tags	Tags assigned to contact.
result_code	Whether or not the response was successful. Examples: 1 = yes, 0 = no
result_message	A custom message that appears explaining what happened. Example: Something is returned
result_output	The result output used. Example: serialize

<?php

$url = 'https://api.t2connect.com/v1/';

//set POST variables
$data = array(
'account' => [YOUR ACCOUNT URL],
'api_key' => [YOUR API KEY],
'api_action' => 'contact_tag_remove',
'api_output' => 'serialize',
'api_action' => 'contact_view_email',
//'api_action' => 'contact_view', // this one also works
'api_output' => 'serialize',
'email' => '[e-mail]',
//'id' => 12, // contact ID (pass this if just contact_view)
);

//open connection
$ch = curl_init($url);
$json_data = json_encode($data);

curl_setopt($ch, CURLOPT_HEADER, 0); // set to 0 to eliminate header info from response
curl_setopt($ch, CURLOPT_POSTFIELDS, $json_data);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_HTTPHEADER, array('Content-Type:application/json'));
curl_setopt($ch, CURLOPT_FOLLOWLOCATION, true);
curl_setopt($ch, CURLOPT_SSL_VERIFYPEER, FALSE); // uncomment if you get no gateway response and are using HTTPS

$response = (string)curl_exec($ch); // execute curl post and store results in $response

if ( !$response ) {
die('Nothing was returned. Do you have a connection?');
}

//close connection
curl_close($ch);

// unserializer
$result = unserialize($response);
// JSON decoder
//$result = json_decode($response, true);

// Result info that is always returned
echo 'Result: ' . ( $result['result_code'] ? 'SUCCESS' : 'FAILED' ) . '<br />';
echo 'Message: ' . $result['result_message'] . '<br />';
// The entire result printed out
echo 'The entire result printed out:<br />';
echo '<pre>';
print_r($result);
echo '</pre>';

// Raw response printed out
echo 'Raw response printed out:<br />';
echo '<pre>';
print_r($response);
echo '</pre>';



?>