Ads · Ad Accounts

Get manager account hierarchy

Fetches a manager account hierarchy. Works with Google Ads.

GEThttps://api.pozy.ai/v1/ads/accounts/hierarchy

Google WorkspacegetAdAccountHierarchy

Request

Send your API key as Authorization: Bearer pz_live_.... Read-only keys can call it. Keys with the ads resource group disabled get 403 resource_group_disabled. Authentication

Query parameters

Name	Type	Notes
`accountId`required	string
`adAccountId`	string
`customerId`	string

Example

curl -X GET "https://api.pozy.ai/v1/ads/accounts/hierarchy?accountId=696e0b682d0a31188e7a2ba9" \
  -H "Authorization: Bearer $POZY_API_KEY"

const res = await fetch("https://api.pozy.ai/v1/ads/accounts/hierarchy?accountId=696e0b682d0a31188e7a2ba9", {
  headers: { Authorization: `Bearer ${process.env.POZY_API_KEY}` },
});
const data = await res.json();
if (!res.ok) throw new Error(data?.error ?? `Request failed with status ${res.status}`);
console.log(data);

import os
import requests

resp = requests.get(
    "https://api.pozy.ai/v1/ads/accounts/hierarchy",
    headers={"Authorization": f"Bearer {os.environ['POZY_API_KEY']}"},
    params={
        "accountId": "696e0b682d0a31188e7a2ba9",
    },
    timeout=30,
)
resp.raise_for_status()
print(resp.json())

Response

200 on success

accountIdstring
rootsarray of object
9 child fields
- customerIdstring
- namestring
  Can be null.
- currencystring
  Can be null.
- timeZonestring
  Can be null.
- managerboolean
- testAccountboolean
- statusstring
  Can be null.
- managerLinksarray of object
  3 child fields
  managerCustomerIdstring
  managerLinkIdstring
  statusstring
  One of ACTIVE, PENDING.
- clientsarray of object
  12 child fields
  customerIdstring
  namestring
  Can be null.
  currencystring
  Can be null.
  timeZonestring
  Can be null.
  managerboolean
  testAccountboolean
  hiddenboolean
  levelinteger
  statusstring
  Can be null.
  parentCustomerIdstring
  Can be null.
  managerLinkIdstring
  Can be null.
  linkStatusstring
  One of ACTIVE, PENDING. Can be null.
directCustomersarray of object
- customerIdstring
- managerboolean
- pendingInvitationsarray of object
  2 child fields
  - managerCustomerIdstring
  - managerLinkIdstring
unavailablearray of object
- customerIdstring
- reasonstring
truncatedboolean
cachedAtstring (date-time)
Can be null.
staleboolean

200 response

{
  "accountId": "696e0b682d0a31188e7a2ba9",
  "roots": [
    {
      "customerId": "691909ff82eb5ed7c816716d",
      "name": "Acme",
      "currency": "USD",
      "timeZone": "America/New_York",
      "manager": true,
      "testAccount": true,
      "status": "active",
      "managerLinks": [
        {
          "managerCustomerId": "6d00a12c8c36af8967d368bc",
          "managerLinkId": "6083e4956af6ca4aa26c607c",
          "status": "ACTIVE"
        }
      ],
      "clients": [
        {
          "customerId": "691909ff82eb5ed7c816716d",
          "name": "Acme",
          "currency": "USD",
          "timeZone": "America/New_York",
          "manager": true,
          "testAccount": true,
          "hidden": true,
          "level": 1,
          "status": "active",
          "parentCustomerId": "65c55e40b26b6e2a3dd836d1",
          "managerLinkId": "6083e4956af6ca4aa26c607c",
          "linkStatus": "ACTIVE"
        }
      ]
    }
  ],
  "directCustomers": [
    {
      "customerId": "691909ff82eb5ed7c816716d",
      "manager": true,
      "pendingInvitations": [
        {
          "managerCustomerId": "6d00a12c8c36af8967d368bc",
          "managerLinkId": "6083e4956af6ca4aa26c607c"
        }
      ]
    }
  ],
  "unavailable": [
    {
      "customerId": "691909ff82eb5ed7c816716d",
      "reason": "string"
    }
  ],
  "truncated": true,
  "cachedAt": "2026-10-02T09:00:00.000Z",
  "stale": true
}

Errors

Errors use one shape: { error, type, code, param?, details? }. The ones you are most likely to see here:

400	invalid_request_error	A parameter or body field is missing or invalid. `param` names it.
401	authentication_error	The API key is missing, revoked or expired.
403	permission_error	The key is scoped to other profiles or has this resource group disabled.
429	rate_limit_error	Too many requests this minute. Wait for `Retry-After` seconds.

Every code is listed in Errors.

More in Ad Accounts

GETList comments on an ad POSTReply to an ad comment POSTHide or unhide an ad comment DELDelete an ad comment GETList TikTok Business Centers GETAd account change / audit log GETA/B tests and lift studies GETList Instagram ad identities GETList Instagram posts to boost GETList advertisable apps GETGet iOS 14 campaign limits GETBusinesses list GETBusiness users GETPage users of a business POSTAssign a user to a Page DELRemove a user from a Page GETList ad labels POSTCreate a Google Ads label PATCHUpdate a Google Ads label DELRemove a Google Ads label POSTAttach a Google Ads label DELDetach a Google Ads label GETList high-demand periods POSTSchedule a budget increase GETList value rule sets POSTCreate a value rule set GETRead a value rule set PUTReplace a value rule set DELDelete a value rule set GETList negative keyword lists POSTCreate a negative keyword list GETGet a negative keyword list PUTRename a negative keyword list DELDelete a negative keyword list PUTReplace negative list keywords GETList account callouts POSTAdd account callouts PUTUpdate account callouts DELRemove account callout GETList account sitelinks POSTAdd account sitelinks PUTUpdate account sitelinks DELRemove account sitelink GETList account snippets POSTAdd account snippets PUTUpdate account snippets DELRemove account snippet POSTInvite a client account to a manager PATCHAccept, decline, cancel or end a manager link GETGet ad account billing POSTSet up ad account billing (monthly invoicing)GETList user access invitations POSTInvite a user to an ad account by email DELRevoke a user access invitation GETList invitations awaiting multi-party approval DELWithdraw an invitation awaiting multi-party approval GETAd account users POSTAssign a user to an ad account DELRemove a user from an ad account GETAd account finances GETCheck an ad account before creating ads GETRead an ad account's campaigns and ad sets live GETList ad accounts POSTCreate ad account PATCHUpdate ad account settings GETGet ad account DSA defaults GETGet DSA recommendations GETList custom conversions POSTCreate custom conversion GETList TikTok ad pixels