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. |
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