Outgoing Reports

Outgoing reports deliver aggregated data to your URL on a schedule. They use the same signed delivery infrastructure as outgoing webhooks — HMAC-SHA256 signature, Timestamp header, authentication, retries, and delivery logs.

Reports are configured in the Open API → Outgoing Reports tab. Each report has a type and a schedule.

Report types

TypeDescription
todo_list_statsAggregated daily todo-list completion statistics, broken down by department and todo template.

Schedules

ScheduleDelivery
dailyEvery day at 07:00 CET.
weeklyEvery Monday at 07:00 CET.

Payload

{
  "id": "550e8400-e29b-41d4-a716-446655440000",
  "event": "monotree.todoliststats.daily",
  "version": "v1",
  "timestamp": 1711270800,
  "payload": {
    "data": {
      "total_lists": 42,
      "total_tasks": 150,
      "completed_tasks": 95,
      "departments": [
        {
          "id": 1,
          "name": "Kitchen",
          "list_count": 5,
          "total_tasks": 45,
          "completed_tasks": 32,
          "completion_percentage": 71.11,
          "todo_list_templates": {
            "data": [
              {
                "id": 1,
                "title": "Morning Checklist",
                "list_count": 2,
                "task_count": 15,
                "completed_count": 10,
                "task_templates_count": 3,
                "completion_percentage": 66.67,
                "todo_tasks": {
                  "data": [
                    {
                      "id": 101,
                      "title": "Check cooler temperatures",
                      "task_count": 5,
                      "completed_count": 3,
                      "completion_percentage": 60,
                      "tasks": {
                        "data": [
                          { "id": 1001, "user": { "name": "John Doe" }, "checked_at": "2026-03-25T07:30:00Z" }
                        ]
                      },
                      "meta": { "total_tasks": 5, "completed_tasks": 3, "completion_percentage": 60 }
                    }
                  ]
                }
              }
            ]
          }
        }
      ]
    }
  }
}

Authentication and signature

Reports support the same authentication options as outgoing webhooks (Bearer token, Basic Auth, API Key header, custom headers). Signature verification works identically — see the Outgoing Webhooks page.