Get Contact Based on Cookie or Email

Scott Wallace
Scott Wallace
  • Updated
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": "john.doe@act-on.com",
  ".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=john.doe@act-on.com

 

Was this article helpful?

0 out of 0 found this helpful

Have more questions? Submit a request