Skip to main content
POST
/
api
/
merchant
/
v2
/
customers
/
rewards
Get customer rewards
curl --request POST \
  --url https://mention-me.com/api/merchant/v2/customers/rewards \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "identifier": {
    "type": "email",
    "value": ""
  }
}
'
{
  "data": {
    "customer": {
      "customerId": "CUST-1234",
      "email": "email@mention-me.com",
      "firstname": "Jane",
      "surname": "Doe",
      "phoneNumbers": [
        "+447123456789",
        "+447987654321"
      ],
      "profileUrl": "https://mention-me.com/merchant/123/customers/43211234"
    },
    "rewards": [
      {
        "id": 123,
        "fulfilledBy": "<string>",
        "amount": 100,
        "description": "<string>",
        "beforePurchase": true,
        "minimumFriendsRequired": 123,
        "spendConstraint": 50,
        "callToActionUrl": "https://www.your-website.com/new-customer-welcome",
        "couponCode": "ABC-DEF-1234",
        "couponLink": "https://www.your-website.com/redeem?code=ABC-DEF-1234",
        "securityCode": "12345",
        "expiryDate": "2023-11-07T05:31:56Z"
      }
    ]
  }
}

Authorizations

Authorization
string
header
required

RFC8725 Compliant JWT

Body

application/json

A customer email address.

identifier
object
required

Response

The rewards issued to the customer matching the identifier.

An object representing the customer and the rewards they were given

data
object
Last modified on June 11, 2026