Get Contact Based on Cookie or Email

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": ""
}

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