---
title: "Account analytics"
method: GET
path: "/v1/analytics"
tags: ["analytics"]
---

# Account analytics

`GET /v1/analytics`

## Request

- Base URL: `https://api.botdog.co`
- URL: `https://api.botdog.co/v1/analytics`
- Auth: API key in header `x-api-key`

Account-level analytics across all campaigns for a period.

## Query parameters

- `period` 'last-7-days' | 'last-30-days' | 'last-90-days'
- `userId` string

## Response `200`

Aggregated outreach metrics for the account

- AnalyticsResponseDto
  - `period` string, required
  - `invitations` InvitationsDto, required
    - `sent` number, required
    - `accepted` number, required
    - `rate` number, required: Acceptance rate as percentage
  - `messages` MessagesDto, required
    - `sent` number, required
    - `replied` number, required
    - `rate` number, required: Reply rate as percentage
  - `campaigns` CampaignsSummaryDto, required
    - `active` number, required
    - `totalLeadsInProgress` number, required

## Other responses

- `401`: Unauthorized. API key is missing or invalid.
- `403`: The key owner has no seat assigned (write endpoints only), the team is on Botdog Managed and so may only read (write endpoints only), or the subscription/plan does not permit this.
- `429`: Rate limit exceeded. Retry after cooldown.

---

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