---
title: "Get account-wide stats"
method: GET
path: "/api/v1/reports/stats"
tags: ["reports"]
---

# Get account-wide stats

`GET /api/v1/reports/stats`

## Request

- Base URL: `https://api.growomat.com`
- URL: `https://api.growomat.com/api/v1/reports/stats`
- Auth: HTTP bearer

Totals for the whole account over a window: impressions, clicks, spend, conversions, conversion value, return on ad spend, click-through rate, cost per click and cost per conversion, plus campaign counts and the total budget. Conversions you uploaded and conversions the platform reported are counted once, never summed twice.

There is no campaign filter here. For one campaign, ad group, keyword or ad use *Get a performance time series* or *Get a performance breakdown* with `scope=campaign:{id}`.

**Errors**

- `400 UNKNOWN_PARAM`: a query parameter this operation does not know. Unknown parameters are refused rather than silently ignored.
- `400 UNKNOWN_ACCOUNT`: `accountId` does not match a connected account.

## Query parameters

- `platformId` string
- `accountId` string
- `period` string
- `startDate` string
- `endDate` string

## Headers

- `X-Space-Id` string

## Response `200`

OK. The result is in `data`. List responses also carry `meta` with `nextCursor` and `total`.

- SuccessEnvelope: The shape of every successful response.
  - `data` unknown, required
  - `meta` object: Present on list responses.
    - `nextCursor` union: Pass as `cursor` to get the next page. `null` on the last page.
      - string
      - number
    - `total` integer: Number of items in this page.

## Other responses

- `400`: The request is malformed or fails validation. `error.code` is `VALIDATION_ERROR` (with `details.issues[]` naming each field), `INVALID_REQUEST` (the body is not valid JSON or has the wrong shape), or one of the specific codes listed in this operation's description.
- `401`: The bearer token is missing, invalid, expired or revoked (`INVALID_TOKEN`).
- `403`: The token lacks the scope this operation needs (`INSUFFICIENT_SCOPE`), the plan is read-only (`READ_ONLY_MODE`), or the caller is not a member of the Space named in `X-Space-Id` (`NOT_A_MEMBER`).
- `404`: No such resource in the active Space (`NOT_FOUND`), or `X-Space-Id` names a Space that does not exist (`SPACE_NOT_FOUND`).
- `409`: The request conflicts with the current state, for example a delete blocked by dependents or a sync already running. This operation's description names the `error.code` values it can return.
- `429`: Too many requests (`RATE_LIMITED`). Wait for the number of seconds in the `Retry-After` header, then retry.

---

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