Ad Accounts

Get manager account hierarchy

Changed on Nov 10, 2026

Shows the Google Ads manager (MCC) and client account tree for a connection, including pending invitations and link status.

How the tree is built

It starts from every customer the Google user behind the connection can access directly and walks each tree to any depth with customer_client. It then reads each manager's own client links, so every client carries its direct parent, the managerLinkId and the link status.

Invitations a manager sent that the client has not accepted yet appear as clients with linkStatus: PENDING (Google returns no name or currency for them).
Refused, canceled and ended links are history and are omitted.
A directly accessible account that is also nested in another tree appears only once, inside that tree.

Response fields

managerLinks (on a root): the managers linked to that account, including invitations it can still accept with PATCH /v1/ads/accounts/manager-links.
directCustomers: every account the Google user accesses directly (the ones this connection can accept or decline invitations for) with their pending invitations, including accounts that are also nested in a tree.
unavailable: customers Google refuses to read (for example a cancelled account), with Google's reason, instead of failing the call.
truncated: true when more exist than the limit. Up to 50 roots and 50 managers per root are read.
cachedAt and stale: the response is cached for 10 minutes per connection.

When the connection is scoped to specific ad accounts, client accounts outside that scope are hidden (managers stay visible).

get/v1/ads/accounts/hierarchy

Request

Base URL
https://zernio.com/api
Auth
HTTP bearer
TypeScript
https://skmtc.dev/zernio/apis/zernio-api/docs/v1/ads/accounts/hierarchy/get.ts
A function with typed inputs. Its response is checked against the schema.

Query parameters

accountIdstring required

Google ads SocialAccount id.

adAccountIdstring

Only return the tree rooted at this customer id (digits only). It must be an account the Google user accesses directly. Omit to list every tree.

customerIdstring

Alias of adAccountId, kept for consistency with the other Google Ads account endpoints.

Response

Manager and client hierarchy

accountIdstring

truncatedboolean

cachedAtstring date-time nullable

When this data was fetched from Google. Null on a live read.

staleboolean

True when Google's quota was exhausted and this is the last successful fetch.

Changes

Nov 10, 2026d568bb00ed73 Revision changes
- info
  added the optional property to the response with the status
- info
  added the optional property to the response with the status
- info
  added the optional property to the response with the status
- info
  added the optional property to the response with the status
- info
  added the optional property to the response with the status
- info
  added the optional property to the response with the status
- info
  added the optional property to the response with the status
- info
  added the optional property to the response with the status
- info
  added the optional property to the response with the status
- info
  added the optional property to the response with the status
- info
  added the optional property to the response with the status
- info
  added the optional property to the response with the status
- info
  added the optional property to the response with the status
- info
  added the optional property to the response with the status
- info
  added the optional property to the response with the status
- info
  added the optional property to the response with the status
- info
  added the optional property to the response with the status
- info
  added the optional property to the response with the status
- info
  added the optional property to the response with the status
- info
  added the optional property to the response with the status
Oct 6, 2026f8c8f34fb41a Revision changes
- warning
  added the new account enum value to the / response property for the response status
- warning
  added the new account enum value to the / response property for the response status
- warning
  added the new account enum value to the / response property for the response status
- warning
  added the new account enum value to the / response property for the response status

Operation history (5 revisions)