Get Contact Based on Cookie or Email

GET https://restapi.actonsoftware.com/api/1/list/lookup/{listID}

1	GET https://restapi.actonsoftware.com/api/1/list/lookup/{listID}

This endpoint allows you to pull a record from a list based on their cookie ID or e-mail address.

Parameters

Name	Parameter Type	Allow Multiple	Required/ Optional	Data Type	Description
Authorization	Header	False	Required	String	Insert your generated access token. ("Bearer {access token}")
cookieid	Query	False	Optional	String	Specify the cookie content value of the record.
email	Query	False	Optional	String	Specify the e-mail address of the record.
listid	Path	False	Required	String	Specify the ID of the list that contains the record.

Parameter Notes

cookie

The cookie content value is stored in the “wp{account #}” cookie created in the visitor’s browser by the beacon tracking code.

Alternatively, “ActOn.Beacon.cookie[{Account #}]” is a code that can be run on a page that contains the Act-On beacon code to return the cookie content value. Please note this does not work on an Act-On landing page.

Response

{
  "contactID": "l-0002:2",
  "First Name": "John",
  "Last Name": "Doe",
  "E-mail Address": "john.doe@act-on.com",
  ".tz": ""
}

{

"contactID": "l-0002:2",

"First Name": "John",

"Last Name": "Doe",

"E-mail Address": "john.doe@act-on.com",

".tz": ""

}

Code Examples

curl -X GET -H "Authorization: Bearer 12345678-9abc-defg-hijk-lmnopqrs" -H "Cache-Control: no-cache" https://restapi.actonsoftware.com/api/1/list/lookup/l-0002?email=john.doe@act-on.com

1	curl -X GET -H "Authorization: Bearer 12345678-9abc-defg-hijk-lmnopqrs" -H "Cache-Control: no-cache" https://restapi.actonsoftware.com/api/1/list/lookup/l-0002?email=john.doe@act-on.com