---
title: "Summarize activity"
method: GET
path: "/v1/activity/summary"
tags: ["Activity"]
---

# Summarize activity

`GET /v1/activity/summary`

## Request

- Base URL: `https://api.talktohumans.app`
- URL: `https://api.talktohumans.app/v1/activity/summary`
- Auth: HTTP bearer

Summarizes LinkedIn activity and performance for the current organization.

## Query parameters

- `from` string
- `to` string
- `timezone` string
- `account_id` string[]
- `user_id` string[]
- `event_type` ActivityEventType[]
- `channel` string[]
- `source` string[]
- `tag` string

## Response `200`

Activity summary.

- ActivitySummaryEnvelope
  - `data` ActivitySummaryResponse, required
    - `generated_at` string, date-time, required
    - `timezone` string, required
    - `totals` ActivitySummaryTotals, required
      - `events` integer, required
      - `unattributed_user_events` integer, required
      - `unattributed_account_events` integer, required
    - `by_event_type` ActivityStringCount[], required
      - `key` string
      - `count` integer, required
      - `missing` boolean
    - `by_channel` ActivityStringCount[], required
      - `key` string
      - `count` integer, required
      - `missing` boolean
    - `by_source` ActivityStringCount[], required
      - `key` string
      - `count` integer, required
      - `missing` boolean
    - `by_user` ActivityIdCount[], required
      - `id` string
      - `count` integer, required
      - `unattributed` boolean
    - `by_account` ActivityIdCount[], required
      - `id` string
      - `count` integer, required
      - `unattributed` boolean
    - `by_template` ActivityTemplateMetrics[], required: Per-template conversion metrics derived from attributed activity facts.
      - `template_key` string, required: Stable opaque template identity including scope and ownership.
      - `template_public_id` string, required
      - `template_type` 'normal' | 'sequence', required
      - `outreach_runs_started` integer, required: Distinct template runs activated after a delivered outbound action.
      - `outreach_runs_replied` integer, required: Activated template runs credited with a reply.
      - `reply_rate` number, double, nullable, required
      - `connection_requests_sent` integer, required
      - `connection_requests_accepted` integer, required
      - `connection_request_acceptance_rate` number, double, nullable, required
    - `template_metrics_basis` string, required: Run activation and single-reply attribution rule used for per-template rates.
    - `metrics` ActivityDerivedMetrics, required
      - `contacts_contacted_outbound` integer, required
      - `contacts_replied_to_outbound` integer, required
      - `reply_rate` number, double, nullable, required
      - `connection_requests_sent` integer, required
      - `connection_requests_accepted` integer, required
      - `connection_request_acceptance_rate` number, double, nullable, required
      - `basis` string, required: Explicit distinct-subject and numerator-intersection rule used for the rates.

## Other responses

- `400`: Invalid request parameters.
- `401`: Missing, malformed, invalid, or retired local API key.
- `403`: API access is not enabled for the organization, the API key cannot resolve to an active organization user, or the credential's user is not an organization admin.
- `429`: Rate limit exceeded. Public routes allow 50 requests per 10 seconds per IP and endpoint.
- `500`: Unexpected server error.

---

[API](https://skmtc.dev/talktohumans/apis/talktohumans-public-api.md) · [All operations](https://skmtc.dev/talktohumans/apis/talktohumans-public-api/llms.txt) · [OpenAPI document](https://skmtc.dev/talktohumans/apis/talktohumans-public-api/revisions/4551ad2f26af?raw)