---
title: "Automation portfolio stats for one shop"
method: GET
path: "/automations/stats"
tags: ["Automations"]
---

# Automation portfolio stats for one shop

`GET /automations/stats`

Shop-level overview of your automations: ``total_automations``, ``live_automations``, ``archived_automations``, and the split between ``regular_automations`` and ``email_automations``, plus three breakdowns — ``by_type`` (Target Collab, Message, Email, Sample Request Processing, …), ``by_status`` (running / stopped / completed / …) and ``by_type_and_state`` (each type split live vs archived) — and an aggregated ``metrics`` block rolled up across the shop's automations.

This is the portfolio view; use ``POST /automations/list`` for the per-automation rows behind it. Pass ``crm_only=true`` to count only automations backed by a CRM group. Single-shop only.

## Query parameters

- `crm_only` boolean — Count only CRM-backed automations (those with a crm_group_id). Defaults to false — all automations.

## Response `200`

Successful Response

- AutomationStatsResponse — Response model for automation statistics
  - `total_automations` integer, required — Total number of automations (regular + email)
  - `live_automations` integer, required — Number of live (active) automations
  - `archived_automations` integer, required — Number of archived automations
  - `email_automations` integer, required — Number of email automations
  - `regular_automations` integer, required — Number of regular (non-email) automations
  - `by_type` object, required — Count of automations by type (includes 'Email' for email automations)
  - `by_status` object, required — Count of automations by status
  - `by_type_and_state` object, required — Count of automations by type and state (live/archived)
  - `metrics` AutomationStatsMetrics, required — Metrics aggregated across automations
    - `total_creators_reached` integer — Total creators reached across all automations
    - `total_sample_requests` integer — Total sample requests across all automations
    - `total_creators` integer — Total creators across all automations
    - `total_emails_sent` integer — Total emails sent across all email automations
    - `total_dm_messages_sent` integer — 30-day DMs sent (denominator for total_reply_rate).
    - `total_dm_response_count` integer — 30-day DM responses (from automation_metrics).
    - `total_reply_rate` number, nullable — 30-day DM reply rate (%).
    - `total_email_open_count` integer — Total email opens.
    - `total_email_reply_count` integer — Total email replies.
    - `total_email_open_rate` number, nullable — Email open rate (%); null when no emails sent.
    - `total_email_reply_rate` number, nullable — Email reply rate (%); null when no emails sent.

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.dev/reacherapp/apis/reacher-data-api.md) · [All operations](https://skmtc.dev/reacherapp/apis/reacher-data-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/reacherapp/reacher-data-api/revisions/5eefff009b5b/schema)