Device IDs

A device_idis needed as input in the batch request for each user to retrieve an email hash. To retrieve the device id, the client must have the SmartTag implemented on site.

The device_idcan be found in the Javascript bouncex.cookie.did.

Limits

Batch Size Limit: maximum of 100 device IDs can be included in a single request. If request contains more, return a 400.

Rate Limit: The API allows up to 100 device IDs to be requested per second per client. If requests exceed exceeding this rate, return a 429.

Request Body

The request must include an array of device IDs. Only device IDs are supported for lookup in this endpoint. If multiple device IDs are provided, the response will return emails for each one.

Field	Type	Required	Description
WebsiteID	string	Yes	The website ID that the lookup will be performed for
DeviceIDs	array of strings	Yes	A list of WKND device IDs (at least one). Each item should be a valid deviceID.

Example Request:

{
    "website_id": "1234",
    "device_ids": ["123456789", "987654321"]
}

Success Response - 200 OK

Example:

{
  "results": [
    {
      "device_id": "123456789",
      "email": "b36a83701f1c3191e19722d6f90274bc1b5501fe69ebf33313e440fe4b0fe210"
    },
    {
      "device_id": "987654321",
      "email": "f660ab912ec121d1b1e928a0bb4bc61b15f5ad44d5efdc4e1c92a25e99b8e44a"
    }
  ]
}

Error Responses:

HTTP Status	Description
401	Unauthorized – invalid or missing credentials.
403	Forbidden – authentication succeeded, but access is not permitted.
429	Rate Limited – too many requests were made in a short period of time.
404	Not Found – no identity could be resolved for the provided IDs.
400	Bad Request – missing or invalid parameters (e.g., invalid device_id, website_id).
500	Internal Server Error – unexpected issue on the server.