Skip to main content
GET
Listar las notificaciones enviadas a una membresía
Returns the wallet messages already sent to a membership, newest first. Check it before notifying again — it is the only record of what this customer has already been told.

Endpoint

Required scope

loyalty:read

Headers

Path parameters

Example request

Response

200 OK

401 Unauthorized

Missing, invalid, revoked, or expired token.

403 Forbidden

The token does not have the loyalty:read scope.

404 Not Found

No membership with that id in your company.

502 Bad Gateway

The loyalty service is unreachable.

Operational notes

  • This response is not paginated and is capped. It returns the most recent messages with a total for convenience; it is a recency view, not a full archive.
  • delivered is the device count at send time, matching the notified figure the notify call returned. A 0 means nobody had the card registered then.
  • A message is recorded even when it reaches nobody. The history tells you what you tried to say, not only what landed.
  • Use it as a frequency guard. Nothing in the API rate-limits wallet notifications per customer beyond the global request limits, so if you are running an automated nudge, check created_at here before sending another.

Authorizations

Authorization
string
header
required

Personal Access Token con prefijo kbai_pk_. Generar desde el portal con permiso developer.manage_tokens.

Path Parameters

id
string
required

Response

200 - application/json
data
object[]
required
total
number
required