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 ID. See Parameter Notes for more information.
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

cookieid

To obtain the cookie ID, use ActOn.Beacon.cookie[{Account #}] in the JS console while on a page that contains the Act-On beacon code. When using this method, replace “{Account #}” with the same account number associated with the beacon tracker. The account numbers must match. (Note that this does not work on an Act-On landing page.)

Response

{
  "contactID": "l-0002:2",
  "First Name": "John",
  "Last Name": "Doe",
  "E-mail Address": "[email protected]",
  ".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/[email protected]