Get Contact Based on Cookie or Email

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

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

Customers wanting to access our API via our gateway in the EU can use this link: 

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

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": "[e-mail]",
  ".tz": ""
}

Code Examples

cURL

curl -X GET -H "Authorization: Bearer 12345678-9abc-defg-hijk-lmnopqrs" -H "Cache-Control: no-cache" https://api.actonsoftware.com/api/1/list/lookup/l-0002?email=[e-mail]