v1

latestOpenAPI 3.0.32026-07-24205887.6 KB
Ad Accounts

Get ad-account 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.

get/open/v1/ad-accounts/{account_id}/summary

Path parameters

account_idstring required

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

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.

Date window. Defaults to last_7d.

Response

Successful Response

codeinteger
messagestring