Loyalty

List a customer marketing-consent history

Append-only GDPR proof-of-consent trail (art. 7.1) of every marketing opt-in/opt-out decision of one loyalty customer, newest first. Each entry records the decision, when it happened, and the channel it came through. Scoped to the caller's organization: the customer must have a loyalty account under it, otherwise 404.

get/v1/loyalty/consent-logs/users/{userId}

Request

  • Base URL: https://api.prod.keyban.io
  • URL: https://api.prod.keyban.io/v1/loyalty/consent-logs/users/{userId}
  • Auth: API key in header X-Api-Key

Path parameters

userIdstring uuid required

Customer (AuthUser) whose consent history is requested

Query parameters

field'id' | 'createdAt' | 'updatedAt' | 'occurredAt' required
order'asc' | 'desc' required
currentPageinteger

1-based page index.

pageSizeinteger

Number of items per page.

Response

Consent history retrieved successfully

totalinteger required

Total count of items matching the query

Example response

{
  "data": [
    {
      "user": "550e8400-e29b-41d4-a716-446655440000",
      "application": "45339a90-40ce-4dd8-85c1-2252cb273282",
      "purpose": "marketing",
      "consent": true,
      "source": "loyalty_app",
      "occurredAt": "2026-06-22T12:27:59Z",
      "termsVersion": "2026-06-marketing-v1"
    }
  ]
}

Changes

No recorded changes to this operation across all 1 revision of this API.