v1
latestOpenAPI 3.1.02026-08-0441813.4 KBShoppers
Batch shopper purchase history
Look up purchase history for one or more shoppers identified by SHA-256 hash of their normalised (lowercase-trimmed) email address. Never send raw email addresses. Up to 20 queries per request. Each result contains a flat items array of merchant interactions; unknown shoppers return an empty items array — there are no 404s.
post/v1/shoppers/history
Request body
Example request
{
"queries": [
{
"query_id": "q1",
"email_sha256": "b94d27b9934d3e08a52e52d7da7dabfac484efe04294e576e50e46a7d3f5a4b8"
}
]
}Response
Per-query shopper history. Each result has a flat items array of merchant interactions. Unknown shoppers return an empty array.
Example response
{
"results": [
{
"query_id": "q1",
"items": [
{
"merchant_id": "01hz4vdrcnxhfmfcvy3rfqk1fp",
"merchant_name": "Acme Corp",
"type": "purchased"
}
]
}
]
}