Skip to main content
GET/products-by-id/:custom_id/

Get product events

You can return all product events occurrences for a specific product.

Attributes

Optional unless marked required

custom_idintegerrequired
A unique identifier for the product provided by the client.

Request​

curl -X GET "https://<your_app_subdomain>.user.com/api/public/products-by-id/:custom_id/" \
-H "Authorization: Token <your_64_char_api_key>" \
-H "Accept: */*; version=2"

Response examples​

{
"count": 2,
"next": null,
"previous": null,
"results": [
{
"id": 3675,
"user_id": 1945,
"timestamp": "2026-11-17T15:02:31Z",
"event_type": "purchase",
"custom_data": {},
"product_custom_id": "rain-jacket"
},
{
"id": 3674,
"user_id": 1945,
"timestamp": "2026-11-17T15:02:31Z",
"event_type": "add to cart",
"custom_data": {},
"product_custom_id": "rain-jacket"
}
]
}

Response fields​

Fields returned in the 200 OK response body.

countinteger
Number of results across all pages. It can lag behind recent changes; see Response pagination.
nextstring (URL)nullable
URL of the next page of results. null on the last page.
previousstring (URL)nullable
URL of the previous page of results. null on the first page.
resultsarray of objects
Results on this page.
results[].idinteger
ID of the product.
results[].user_idinteger
ID of the contact the event belongs to.
results[].timestampstring (date-time)
When the event happened, ISO 8601.
results[].event_typestring
Type of the event, for example view, add to cart or purchase.
results[].custom_dataobject
Data sent with the event.
results[].product_custom_idstring
Custom ID of the product the event is for.
note

Errors that can come from any endpoint (401, 429, 500, 502, 504) are described in HTTP response codes.