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

# Get Activity Stats

> Retrieve activity analytics statistics within a specified time range.

## Body Parameters

<ParamField body="start" type="number" required>
  Start timestamp (ms) for the analytics period.
</ParamField>

<ParamField body="end" type="number" required>
  End timestamp (ms) for the analytics period.
</ParamField>

<ParamField body="processId" type="string">
  Optional ID to segment stats by process.
</ParamField>

<ParamField body="groupId" type="string">
  Optional ID to segment stats by group.
</ParamField>

<ParamField body="timezoneOffsetMinutes" type="number">
  Optional timezone offset in minutes (e.g., 330 for IST) used for unique-lead day buckets.
</ParamField>

<ParamField body="includeUniqueLeads" type="boolean">
  Optional flag to include a `unique` block with unique-lead metrics (attempts, connected, interested).
</ParamField>

## Response

<ResponseField name="success" type="boolean">
  Indicates if the request was successful
</ResponseField>

<ResponseField name="data" type="object">
  The analytics statistics data.

  <Expandable title="Analytics Properties">
    <ResponseField name="attempts" type="object">
      Call attempts analytics. Structure includes `total` count and `data` time-series array.

      <Expandable title="Structure">
        <ResponseField name="total" type="number">Total count</ResponseField>

        <ResponseField name="data" type="array">
          Array of `{time: number, value: number}` objects. `time` is a Unix epoch timestamp (ms).
        </ResponseField>
      </Expandable>
    </ResponseField>

    <ResponseField name="connected" type="object">
      Connected calls analytics. Same structure as `attempts`.

      <Expandable title="Structure">
        <ResponseField name="total" type="number">Total count</ResponseField>

        <ResponseField name="data" type="array">
          Array of `{time: number, value: number}` objects. `time` is a Unix epoch timestamp (ms).
        </ResponseField>
      </Expandable>
    </ResponseField>

    <ResponseField name="incoming" type="object">
      Incoming calls analytics. Same structure as `attempts`.

      <Expandable title="Structure">
        <ResponseField name="total" type="number">Total count</ResponseField>

        <ResponseField name="data" type="array">
          Array of `{time: number, value: number}` objects. `time` is a Unix epoch timestamp (ms).
        </ResponseField>
      </Expandable>
    </ResponseField>

    <ResponseField name="meaningfullyHandled" type="object">
      Meaningfully handled calls analytics. Same structure as `attempts`.

      <Expandable title="Structure">
        <ResponseField name="total" type="number">Total count</ResponseField>

        <ResponseField name="data" type="array">
          Array of `{time: number, value: number}` objects. `time` is a Unix epoch timestamp (ms).
        </ResponseField>
      </Expandable>
    </ResponseField>

    <ResponseField name="interested" type="object">
      Interested calls analytics. Same structure as `attempts`.

      <Expandable title="Structure">
        <ResponseField name="total" type="number">Total count</ResponseField>

        <ResponseField name="data" type="array">
          Array of `{time: number, value: number}` objects. `time` is a Unix epoch timestamp (ms).
        </ResponseField>
      </Expandable>
    </ResponseField>

    <ResponseField name="unique" type="object">
      Unique-lead metrics returned only when `includeUniqueLeads` is true.

      <Expandable title="Structure">
        <ResponseField name="attempts" type="object">Unique leads attempted. Same structure as `attempts`.</ResponseField>
        <ResponseField name="connected" type="object">Unique leads connected. Same structure as `attempts`.</ResponseField>
        <ResponseField name="interested" type="object">Unique leads interested. Same structure as `attempts`.</ResponseField>
      </Expandable>
    </ResponseField>
  </Expandable>
</ResponseField>
