Skip to main content
GET
/
pulse
GET /pulse
curl --request GET \
  --url https://api.example.com/pulse
{
  "community_health_score": 72,
  "health_trend": "up",
  "moods": [
    { "name": "Joy", "pct": 47, "count": 145, "trend": "up", "delta": 4 },
    { "name": "Hope", "pct": 24, "count": 74, "trend": "flat", "delta": 0 }
  ],
  "states": [
    { "name": "Loneliness", "pct": 29, "trend": "flat", "delta": 0, "hot": false }
  ],
  "topics": [
    { "name": "Feeling replaceable", "trend": "up", "delta": 8, "hot": true }
  ],
  "actions": [
    {
      "priority": 1,
      "label": "Wanting to be seen at +6%",
      "action": "Activate peer matching for users sharing this theme"
    }
  ],
  "generated_at": "2026-06-15T00:00:00Z"
}
Returns the full community Affective Intelligence payload for the requesting organisation’s cohort.

​
Query parameters

​
window
string
default:"30d"
Time window: 7d, 30d, 60d, or all.
​
layers
string
default:"moods,states,topics,actions"
Comma-separated signal layers to include.
​
anon_floor
integer
default:"10"
Minimum group size for data to be returned.

​
Response

​
community_health_score
integer
Composite score from 0–100.
​
health_trend
string
up, flat, or down.
​
moods
array
Array of {name, pct, count, trend, delta} objects.
​
states
array
Array of {name, pct, trend, delta, hot} objects.
​
topics
array
Array of {name, trend, delta, hot} objects.
​
actions
array
Array of {priority, label, action} objects.
​
generated_at
string
ISO 8601 timestamp.

​
Example

curl -X GET "https://api.togetherwithkai.com/v1/affective/pulse?window=30d&layers=all" \
  -H "Authorization: Bearer YOUR_API_KEY"

{
  "community_health_score": 72,
  "health_trend": "up",
  "moods": [
    { "name": "Joy", "pct": 47, "count": 145, "trend": "up", "delta": 4 },
    { "name": "Hope", "pct": 24, "count": 74, "trend": "flat", "delta": 0 }
  ],
  "states": [
    { "name": "Loneliness", "pct": 29, "trend": "flat", "delta": 0, "hot": false }
  ],
  "topics": [
    { "name": "Feeling replaceable", "trend": "up", "delta": 8, "hot": true }
  ],
  "actions": [
    {
      "priority": 1,
      "label": "Wanting to be seen at +6%",
      "action": "Activate peer matching for users sharing this theme"
    }
  ],
  "generated_at": "2026-06-15T00:00:00Z"
}