Get ad-account ad

Full creative (text copy + image / video assets + CTA) plus per-ad metric values over the requested window — the drill-down for a single ad returned by GET /open/v1/ad-accounts/{account_id}/ads.

Metrics: metrics is keyed by metric id, with metric_names giving each id's display name. Ids come from GET /open/v1/ad-accounts/{account_id}/metrics; pass them in metrics to add custom conversions, custom events and Atria custom metrics on top of the default set. null means no data for that metric in the window. Figures can differ slightly from the ad platform's own reporting.

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.

Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…
Path Params
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).

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

Query Params
string
enum
Defaults to last_7d

Date window.

Allowed:
string

Comma-separated metric ids to add to metrics, on top of the account's default set. Get ids from GET /open/v1/ad-accounts/{account_id}/metrics — hand-built ids are rejected. Up to 20 per request.

Responses

Language
Credentials
Header
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json