> ## Documentation Index
> Fetch the complete documentation index at: https://docs.salessequencer.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Analytics for a date range

> Daily and hourly sends/replies plus breakdowns by campaign, mailbox and domain. Dates are IST days. 'from' and 'to' take effect only when BOTH are given, otherwise the range preset applies (default 14d). The range is capped at 365 days and the end at today. A bad date returns 400 {error}. Cached about 20 seconds.

**Minimum role:** `view` (`x-min-role`). **Destructive:** `false` (`x-destructive`).



## OpenAPI

````yaml /openapi.json get /analytics
openapi: 3.0.3
info:
  title: Sales Sequencer API
  version: '1'
  description: >-
    Every Sales Sequencer action over HTTP. Each call runs as the API key's
    creator, with that user's role, in the key's workspace. Auth: X-API-Key
    header.
servers:
  - url: https://api.salessequencer.com/api/v1
security:
  - key: []
paths:
  /analytics:
    get:
      tags:
        - Analytics
      summary: Analytics for a date range
      description: >-
        Daily and hourly sends/replies plus breakdowns by campaign, mailbox and
        domain. Dates are IST days. 'from' and 'to' take effect only when BOTH
        are given, otherwise the range preset applies (default 14d). The range
        is capped at 365 days and the end at today. A bad date returns 400
        {error}. Cached about 20 seconds.


        **Minimum role:** `view` (`x-min-role`). **Destructive:** `false`
        (`x-destructive`).
      operationId: spa_analytics
      parameters:
        - description: 'Preset: today, yesterday, 7d, 14d (default), 30d, 90d.'
          in: query
          name: range
          required: false
          schema:
            type: string
        - description: Start date YYYY-MM-DD (needs 'to').
          in: query
          name: from
          required: false
          schema:
            type: string
        - description: End date YYYY-MM-DD (needs 'from').
          in: query
          name: to
          required: false
          schema:
            type: string
        - description: Limit to one campaign id.
          in: query
          name: campaign
          required: false
          schema:
            type: integer
      responses:
        '200':
          description: >-
            JSON {range:{preset, from, to, days}, campaign, totals:{sent,
            reached, failed, replies, positive, sent_per_day, reply_per_1k,
            emails_per_positive}, lifetime:{reached, bounced, pending,
            bounce_rate}, series, hours:[{hour,sent,replies}], stages,
            by_campaign, by_mailbox (top 200), by_domain, campaigns}.
components:
  securitySchemes:
    key:
      in: header
      name: X-API-Key
      type: apiKey

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.