Ads · Ad Accounts

Read an ad account's campaigns and ad sets live

Reads an ad account's campaigns and ad sets live. Works with Meta Ads and TikTok Ads.

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

Facebook and Instagram and TikTokgetAdAccountLiveEntities

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`required	string
`status`	string
`level`	string	One of `campaign`, `adSet`
`limit`	integer	Default `200`1 to 500
`after`	string

Example

curl -X GET "https://api.pozy.ai/v1/ads/accounts/live?accountId=696e0b682d0a31188e7a2ba9&adAccountId=666219aad7bab67ace411e4f&limit=200" \
  -H "Authorization: Bearer $POZY_API_KEY"

const res = await fetch("https://api.pozy.ai/v1/ads/accounts/live?accountId=696e0b682d0a31188e7a2ba9&adAccountId=666219aad7bab67ace411e4f&limit=200", {
  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/live",
    headers={"Authorization": f"Bearer {os.environ['POZY_API_KEY']}"},
    params={
        "accountId": "696e0b682d0a31188e7a2ba9",
        "adAccountId": "666219aad7bab67ace411e4f",
        "limit": 200,
    },
    timeout=30,
)
resp.raise_for_status()
print(resp.json())

Response

200 on success

accountIdstring
adAccountIdstring
platformstring
One of facebook, tiktok.
currencystring
readAtstring (date-time)
campaignsarray of object
12 child fields
- platformCampaignIdstring
- campaignNamestring
  Can be null.
- platformCampaignStatusstring
  Can be null.
- configuredStatusstring
  Can be null.
- statusstring
- budgetobject
  Can be null.
  2 child fields
  amountnumber
  typestring
  One of daily, lifetime.
- dailyBudgetnumber
  Can be null.
- lifetimeBudgetnumber
  Can be null.
- budgetModestring
  Can be null.
- budgetRemainingnumber
  Can be null.
- spendCapnumber
  Can be null.
- bidStrategystring
  Can be null.
adSetsarray of object
19 child fields
- platformAdSetIdstring
- adSetNamestring
  Can be null.
- platformCampaignIdstring
  Can be null.
- platformAdSetStatusstring
  Can be null.
- configuredStatusstring
  Can be null.
- statusstring
- budgetobject
  Can be null.
  2 child fields
  amountnumber
  typestring
  One of daily, lifetime.
- dailyBudgetnumber
  Can be null.
- lifetimeBudgetnumber
  Can be null.
- budgetModestring
  Can be null.
- budgetRemainingnumber
  Can be null.
- bidStrategystring
  Can be null.
- bidAmountnumber
  Can be null.
- optimizationGoalstring
  Can be null.
- billingEventstring
  Can be null.
- promotedObjectobject
  Can be null.
- targetingobject
  Can be null.
- scheduleobject
  Can be null.
  2 child fields
  startDatestring (date-time)
  endDatestring (date-time)
- adSchedulearray of object
  One of:
  Meta Ad Schedule (4 fields)
  dayOfWeekstringrequired
  One of MONDAY, TUESDAY, WEDNESDAY, THURSDAY, FRIDAY, SATURDAY, SUNDAY.
  startHourintegerrequired
  0 to 23.
  endHourintegerrequired
  1 to 24.
  timezoneTypestring
  One of USER, ADVERTISER. Default USER.
pagingobject
- campaignsobject
  1 child field
  - afterstring
    Can be null.
- adSetsobject
  1 child field
  - afterstring
    Can be null.

200 response

{
  "accountId": "696e0b682d0a31188e7a2ba9",
  "adAccountId": "666219aad7bab67ace411e4f",
  "platform": "facebook",
  "currency": "USD",
  "readAt": "2026-10-02T09:00:00.000Z",
  "campaigns": [
    {
      "platformCampaignId": "68f1e8569b986839e821d8ba",
      "campaignName": "Acme",
      "platformCampaignStatus": "instagram",
      "configuredStatus": "active",
      "status": "active",
      "budget": {
        "amount": 12.5,
        "type": "daily"
      },
      "dailyBudget": 12.5,
      "lifetimeBudget": 12.5,
      "budgetMode": "string",
      "budgetRemaining": 12.5,
      "spendCap": 12.5,
      "bidStrategy": "string"
    }
  ],
  "adSets": [
    {
      "platformAdSetId": "6749c05fd96acf71ce38cbc7",
      "adSetName": "Acme",
      "platformCampaignId": "68f1e8569b986839e821d8ba",
      "platformAdSetStatus": "instagram",
      "configuredStatus": "active",
      "status": "active",
      "budget": {
        "amount": 12.5,
        "type": "daily"
      },
      "dailyBudget": 12.5,
      "lifetimeBudget": 12.5,
      "budgetMode": "string",
      "budgetRemaining": 12.5,
      "bidStrategy": "string",
      "bidAmount": 12.5,
      "optimizationGoal": "string",
      "billingEvent": "string",
      "promotedObject": {},
      "targeting": {},
      "schedule": {
        "startDate": "2026-10-02T09:00:00.000Z",
        "endDate": "2026-10-02T09:00:00.000Z"
      },
      "adSchedule": [
        {
          "dayOfWeek": "MONDAY",
          "startHour": 1,
          "endHour": 1,
          "timezoneType": "USER"
        }
      ]
    }
  ],
  "paging": {
    "campaigns": {
      "after": "string"
    },
    "adSets": {
      "after": "string"
    }
  }
}

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 GETGet manager account hierarchy 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 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