---
title: "List connected ad accounts"
method: GET
path: "/open/v1/ad-accounts"
tags: ["Ad Accounts"]
---

# List connected ad accounts

`GET /open/v1/ad-accounts`

List Meta and TikTok ad accounts the calling workspace has connected. Use the returned `id` as `account_id` on the per-account endpoints (`/open/v1/ad-accounts/{account_id}/summary`, `/open/v1/ad-accounts/{account_id}/ads`, `/open/v1/ad-accounts/{account_id}/ads/{platform_ad_id}`).

Scoped to the workspace bound to your API key. No pagination — workspaces rarely connect more than a handful of accounts.

Returns: `code=0` success; `code=40001` workspace context missing.

## Response `200`

Successful Response

- OpenAdAccountListResponse — Envelope for all open API responses. code=0 means success.
  - `code` integer
  - `message` string
  - `data` OpenAdAccountListData
    - `items` OpenAdAccount[]
      - `id` string, required — Internal Atria account id as 32-char hex (no dashes), e.g. `00000000000040008000000000000001`. Either form parses on downstream paths.
      - `ad_account_id` string — Platform-side identifier (Meta ad-account id, TikTok advertiser id).
      - `name` string — Display name.
      - `platform` string, required — `facebook` or `tiktok`.
      - `currency` string — ISO-4217 currency code.
      - `timezone_name` string — IANA timezone name. Set for Meta accounts; null for TikTok.
      - `status` string — Account status: `active`, `init`, `miss_permission`, `invalid_token`, `unknown_error`, `active_filling_gap`, `disabled`, `paused`.
      - `brand_id` string — Linked brand id if any (see `GET /open/v1/owned-brands` in the same phase).
    - `total` integer — Total number of connected accounts in the workspace.

---

[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/versions/548d57b611ea/schema)