Daily Relationship Question API

Retrieve and answer shared daily relationship questions for partners.

Overview

The Daily Relationship Question API provides a shared question experience for partners with chat-like conversations.

This API allows you to:

Get a daily relationship question shared between partners
Submit an answer to a relationship question
View both your answer and your partner's answer
🆕 NEW: Access full conversation history in chat format with timestamps and user IDs
🆕 NEW: Support for multiple replies and ongoing conversations on each question

🆕 New Chat Feature

All relationship question responses now include a "conversation" array that contains all messages, replies, and reactions in chronological order - perfect for building WhatsApp/iMessage-style chat interfaces between partners.

Key Feature

Partners receive the same question each day, allowing them to compare their answers and discuss the topic together in an ongoing conversation.

Each couple receives one shared relationship question per day. Both partners can answer independently, and both can see each other's answers. Questions are not repeated for at least 30 days to ensure variety. All responses are stored as conversation messages with proper timestamps and user attribution.

Managing Notifications

After notifications are sent to users, you can use our API to manage them:

Get Unread Notification Count

Useful for displaying notification badges in your app:

// Example for getting unread notification count
GET /api/users/user/{userId}/notifications/unread

// Response
{
  "success": true,
  "unreadCount": 5
}

Mark Notification as Read

Call this when a user views a notification:

// Example for marking a single notification as read
PATCH /api/users/user/{userId}/notifications
Content-Type: application/json

{
  "notificationId": "notification_id_1"
}

// Response
{
  "success": true,
  "message": "Notification marked as read"
}

Mark All Notifications as Read

Useful for "Clear all" functionality:

// Example for marking all notifications as read
PATCH /api/users/user/{userId}/notifications
Content-Type: application/json

{
  "markAll": true
}

// Response
{
  "success": true,
  "message": "All notifications marked as read",
  "count": 12
}