---
title: "Get ad-account summary"
method: GET
path: "/open/v1/ad-accounts/{account_id}/summary"
tags: ["Ad Accounts"]
---

# Get ad-account summary

`GET /open/v1/ad-accounts/{account_id}/summary`

Account-wide KPI total for the requested window. One row of metrics (spend / impressions / clicks / ctr / cpm / cpc / conversions / cost_per_conversion / roas), aggregated by the ad platform.

Returns: `code=0` success; `code=40001` invalid `account_id` or workspace context missing; `code=40401` when the account does not exist or belongs to a different workspace; `code=50001` when the upstream platform API is unavailable.

## Path parameters

- `account_id` string, required — Internal Atria ad-account id (UUID; dashed or 32-char hex both parse). Obtain it from `GET /open/v1/ad-accounts` (`items[].id`).

## Query parameters

- `period` 'last_7d' | 'last_14d' | 'last_30d' — An enumeration.

## Response `200`

Successful Response

- OpenAccountSummaryResponse — Envelope for all open API responses. code=0 means success.
  - `code` integer
  - `message` string
  - `data` OpenAccountSummary — Account-wide KPI summary for a date window. Backed by a single Meta / TikTok Marketing-API call at account level — never routed through Atria's analytics aggregation layer.
    - `account_id` string, required — Atria-internal ad-account UUID (no dashes).
    - `platform` string, required — `facebook` or `tiktok`.
    - `currency` string — ISO-4217 currency code for all monetary fields.
    - `period` 'last_7d' | 'last_14d' | 'last_30d', required — An enumeration.
    - `date_start` string, required — Window start, ISO-8601 `YYYY-MM-DD`.
    - `date_stop` string, required — Window stop, ISO-8601 `YYYY-MM-DD` (inclusive).
    - `metrics` OpenAdMetrics, required — Performance metrics over the requested date window. Shared by `OpenAccountSummary`, `OpenOwnAdListItem`, and `OpenOwnAd`. All numeric fields are denominated in the ad-account's currency (see the enclosing response's `currency` field).
      - `spend` number, required — Total spend in the account's currency.
      - `impressions` integer, required — Total impressions.
      - `clicks` integer, required — Total clicks (link clicks where applicable).
      - `ctr` number — Click-through rate (clicks / impressions). Null when impressions=0.
      - `cpm` number — Cost per 1000 impressions (spend / impressions × 1000). Null when impressions=0.
      - `cpc` number — Cost per click (spend / clicks). Null when clicks=0.
      - `conversions` integer — Number of conversions. Facebook: `omni_purchase` action count. TikTok: advertiser-defined conversion count. Null when the account has not configured conversion tracking.
      - `cost_per_conversion` number — Spend / conversions. Null when conversions is null or 0.
      - `roas` number — Return on ad spend (purchase value / spend). Null when the account has no purchase-value tracking, or when spend=0.

## Other responses

- `400` — Invalid request — a query parameter, path parameter, or body field failed validation.

---

[API](https://skmtc.net/tryatria/apis/atria-open-api.md) · [All operations](https://skmtc.net/tryatria/apis/atria-open-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/tryatria/atria-open-api/revisions/548d57b611ea/schema)