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 email 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. |
| 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://restapi.actonsoftware.com/api/1/list/lookup/l-0002?email=john.doe@act-on.com