---
title: "The tools: Community, SOS and time capsules in the period, counts only"
method: GET
path: "/api/analytics/tools"
tags: ["analytics"]
---

# The tools: Community, SOS and time capsules in the period, counts only

`GET /api/analytics/tools`

## Request

- Base URL: `https://api.corabea.it` (the document declares no server; this is the origin it was published from)
- URL: `https://api.corabea.it/api/analytics/tools`
- Auth: HTTP bearer

## Query parameters

- `from_date` string, date, nullable: First day of the period (YYYY-MM-DD), inclusive; none for since the first use.
- `to_date` string, date, required: Last day of the period (YYYY-MM-DD), inclusive.

## Response `200`

Successful Response

- ToolsAnalyticsResponse
  - `from_date` string, date, required
  - `to_date` string, date, required
  - `on_path_now` integer, required: Patients on a path today with the new app, who have the tools
  - `community` CommunityUsage, required
    - `openers` integer, required: People who opened the Community in the period
    - `open_days` integer, required: Days with an opening, summed over the people
    - `on_path_not_openers` integer: On a path today and no opening in the period
    - `posts` integer, required: Posts written by patients in the period
    - `authors` integer, required
    - `approved` integer, required
    - `rejected` integer, required
    - `pending` integer, required
    - `median_review_hours` number, nullable: From writing to the team's review
    - `team_posts` integer, required
    - `by_category` ToolsCount[]
      - `key` string, required
      - `label` string, required
      - `count` integer, required
    - `hearts` integer, required: «Mi ha aiutato» given in the period
    - `heart_givers` integer, required
    - `top_posts` ToolsTopPost[]: Most hearts received in the period
      - `id` string, required
      - `title` string, required
      - `category` string, required
      - `hearts` integer, required
    - `on_path` CommunityGroupUsage: The Community among who is on a path today with the new app (the new questionnaire answered).
      - `people` integer, required
      - `openers` integer, required
      - `open_days` integer, required
      - `authors` integer, required: Of them, who wrote a post in the period
      - `heart_givers` integer, required: Of them, who gave a «Mi ha aiutato» in the period
  - `sos` SosUsage, required
    - `openers` integer, required: People who opened the SOS online in the period
    - `open_days` integer, required
    - `on_path_not_openers` integer: On a path today and no opening in the period
    - `list_openers` integer, required: People who opened their lists
    - `items_added` integer, required: Items written in the lists in the period, never their text
    - `item_writers` integer, required
    - `by_list` ToolsCount[]
      - `key` string, required
      - `label` string, required
      - `count` integer, required
    - `calls_booked` integer, required: Support calls booked from the SOS in the period
    - `calls_done` integer, required
    - `calls_cancelled` integer, required
    - `call_people` integer, required
    - `on_path` SosGroupUsage: The SOS among who is on a path today with the new app (the new questionnaire answered).
      - `people` integer, required: On a path today with the new app
      - `sos_openers` integer, required: Of them, who opened the SOS in the period
      - `sos_open_days` integer, required: Days with an SOS opening, summed over them
      - `list_openers` integer, required
      - `item_writers` integer, required
      - `call_people` integer, required: Who booked a support call from the SOS in the period
    - `vs_daily_support` SosVsDailySupport: The same people on a path with the new app, who have both: the SOS or the daily support, in the period.
      - `people` integer, required: On a path with the new app
      - `sos_openers` integer, required
      - `daily_openers` integer, required: Who opened the daily support in the period: a day, or its screen the first time
      - `both` integer, required
      - `sos_only` integer, required
      - `daily_only` integer, required
      - `neither` integer, required
      - `sos_days_average` number, nullable: Days with an SOS opening, average over who opened it
      - `daily_days_average` number, nullable: Days with a daily support opening, average over who opened it
  - `capsules` CapsuleUsage, required
    - `written` integer, required: Time capsules written in the period, never their text
    - `writers` integer, required
    - `scheduled` integer, required
    - `sent` integer, required
    - `failed` integer, required
    - `median_days_ahead` number, nullable: From writing to the chosen delivery

## Other responses

- `422`: Validation Error

## Changes

- **2026-10-16** `aeba72b14e14`: 3 info
  - added the optional property `community/on_path` to the response with the `200` status
  - added the optional property `sos/on_path` to the response with the `200` status
  - added the optional property `sos/vs_daily_support` to the response with the `200` status
- **2026-10-15** `aa886bd28686`: 2 info
  - added the optional property `community/on_path_not_openers` to the response with the `200` status
  - added the optional property `sos/on_path_not_openers` to the response with the `200` status
- **2026-10-14** `20ab9e4e7f8a`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/corabea/apis/corabea-api/changes/api/analytics/tools/get.md)

---

[API](https://skmtc.dev/corabea/apis/corabea-api.md) · [All operations](https://skmtc.dev/corabea/apis/corabea-api/llms.txt) · [OpenAPI document](https://skmtc.dev/corabea/apis/corabea-api/revisions/64c5370369f5?raw)