---
title: "Get account analytics for an integration"
method: GET
path: "/v1/workspaces/{workspaceId}/analytics"
tags: ["Analytics"]
---

# Get account analytics for an integration

`GET /v1/workspaces/{workspaceId}/analytics`

## Request

- Base URL: `https://api.maevesocial.com` (the document declares no server; this is the origin it was published from)
- URL: `https://api.maevesocial.com/v1/workspaces/{workspaceId}/analytics`
- Auth: HTTP bearer

## Path parameters

- `workspaceId` string, uuid, required

## Query parameters

- `startDate` string, nullable
- `endDate` string, nullable
- `integrationId` string, uuid, required
- `days` union
  - 'all'
  - integer

## Response `200`

Account analytics metrics

- object
  - `data` PublicAnalyticsMetricsResponseDto, required
    - `metrics` PublicAnalyticsMetricDto[], required
      - `key` string, required
      - `label` string, required
      - `currentValue` number, required
      - `percentageChange` number
      - `history` PublicAnalyticsHistoryPointDto[], required
        - `date` string, required
        - `value` number, required
      - `previousHistory` PublicAnalyticsHistoryPointDto[]: Daily series for the comparison period that percentageChange is measured against.
        - `date` string, required
        - `value` number, required
      - `historyStatus` 'available' | 'partial' | 'unavailable'
      - `historyMessage` string
      - `valueSemantics` 'lifetime' | 'windowed': lifetime: the total to date. windowed: counted within the requested period only.
    - `warnings` PublicAnalyticsWarningDto[]
      - `code` string, required
      - `message` string, required
      - `severity` 'info' | 'warning' | 'error', required
      - `metadata` object
    - `dataQuality` PublicAnalyticsDataQualityDto
      - `status` 'complete' | 'partial' | 'stale' | 'cached_error' | 'refreshing', required
      - `lastSuccessfulFetch` string
      - `cacheAge` number
      - `missingMetrics` string[]
  - `meta` unknown, required

---

[API](https://skmtc.dev/maevesocial/apis/maeve-social-api.md) · [All operations](https://skmtc.dev/maevesocial/apis/maeve-social-api/llms.txt) · [OpenAPI document](https://skmtc.dev/maevesocial/apis/maeve-social-api/revisions/1b00fd7e4b15?raw)
