Skip to content

Notification Event ​

All notifications include the following fields:

  • notificationId — UUIDv4 or null
  • ref — always null for notifications

chat.v1.message_sent ​

Message received, sent, unsent, or got a reaction.

chat.v1.refresh_dynamic ​

Album shared, unshared, expiration settings changed or viewed.

tap.v1.tap_sent ​

Tap received or sent.

  • everything from Notification Event
  • payload — object
    • timestamp
    • senderId
    • recipientId
    • tapType
    • senderProfileImageHash
    • senderDisplayName
    • isMutual

chat.v1.conversation.delete ​

Conversation deleted, e.g. when another profile blocked you. Also fires for unblock events.

chat.v1.conversation_read ​

Display read receipt. Sent to all chat participants including yourself reading from another device, check profileId to distinguish. Only sent if user has a paid subscription or entitlement for read states. lastReadTimestamp still returns correct value, usable for polling.

  • everything from Notification Event
  • payload — object
    • conversationId — Conversation ID
    • profileId — id of the participant who performed the read, sent as a string
    • timestamp — unix timestamp in milliseconds; all messages up to and including this time are read by profileId

chat.v1.message_deleted ​

Message deleted.

chat.v1.conversation.update ​

Conversation metadata changed.

chat.v1.typing_status ​

Typing indicator changed.

  • everything from Notification Event
  • payload — object
    • conversationId — Conversation ID
    • profileId — id of the participant whose typing status changed
    • status — one of Typing, Cleared, Sent

chat.v1.cache_bomb.inbox ​

Signals the client to refresh its inbox.

notification.undelivered ​

WIP

viewed_me.v1.new_view_received ​

New view received, e.g. when another profile views your profile.

  • everything from Notification Event
  • payload — object
    • viewedCount — total number of profiles that viewed you, including the most recent one
    • mostRecent — object
      • profileId — ID of the profile that viewed
      • photoHash — hash of the profile photo, if available
      • timestamp — unix timestamp in milliseconds of the view

Open Grind is not affiliated with Grindr in any way.