Sign in

v1

latestOpenAPI 3.0.32026-07-24205887.6 KB
Ad Accounts

Get ad-account ad

Full creative (text copy + image / video assets + CTA) plus per-ad performance metrics over the requested window. Creative is served from Atria's server-side cache of the Meta / TikTok Marketing API responses; metrics come from one filtered platform-API call.

Returns: code=0 success; code=40001 invalid path parameters or workspace context missing; code=40401 when the account or the platform_ad_id is not accessible to the caller; code=50001 when the upstream platform API is unavailable.

get/open/v1/ad-accounts/{account_id}/ads/{platform_ad_id}

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).

platform_ad_idstring required

Platform-native ad id (Meta Marketing API ad_id, TikTok Marketing API ad_id). Obtain from GET /open/v1/ad-accounts/{account_id}/ads (items[].platform_ad_id). Not the Atria-library ad_id used by /open/v1/ad-library/{ad_id} — different namespace, do not confuse the two.

Platform-native ad id (Meta Marketing API ad_id, TikTok Marketing API ad_id). Obtain from GET /open/v1/ad-accounts/{account_id}/ads (items[].platform_ad_id). Not the Atria-library ad_id used by /open/v1/ad-library/{ad_id} — different namespace, do not confuse the two.

Query parameters

period'last_7d' | 'last_14d' | 'last_30d'

An enumeration.

Date window.

Response

Successful Response

codeinteger
messagestring