Skip to main content
GET
Read an ad account's campaigns and ad sets live

Request contract

  • Method and path: GET /apis/v1/ads/accounts/live
  • Availability: enabled
  • Request URL template: https://api.aisa.one/apis/v1/ads/accounts/live
  • connectionId: query; required
  • adAccountId: query; required
  • status: query; optional
  • level: query; optional
  • limit: query; optional
  • after: query; optional
  • Runtime facts: fe60122939c67dc98a3a6ac6b97bd5c326b526105150c8959304dd2160d4dd09
Complete OpenAPI definition Effective request and pricing declaration (including authentication and referenced schemas):

Cost and request rules

A request reference price is not currently available; use a request quote where supported. Account-specific pricing and final settlement may differ. Published reference values are not an account-specific quote or a settled charge. For endpoints supporting X-AISA-Cost-Mode: quote, obtain a free quote for your exact request before execution; reconcile the settled cost with response metadata and Usage Logs. USD amounts use 1,000,000 integer micro-USD per dollar.

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Query Parameters

connectionId
string
required

The ads connection (adc_...) the request runs on: one of yours, from GET /apis/v1/ads/connections. On a request with a JSON body it may be sent as a top-level body member instead.

Pattern: ^adc_[0-9A-Za-z]+$
adAccountId
string
required

Meta ad account id (act_) or TikTok advertiser id (digits).

status
string

Comma-separated Meta effective_status values to keep: ACTIVE, PAUSED, IN_PROCESS, WITH_ISSUES, DELETED, ARCHIVED, and CAMPAIGN_PAUSED (ad sets only; the campaigns level ignores it). Defaults to every status except DELETED and ARCHIVED.

level
enum<string>

Read only one level. Required with after. Both levels are read when omitted.

Available options:
campaign,
adSet
limit
integer
default:200

Maximum rows per level in this response.

Required range: 1 <= x <= 500
after
string

Cursor from paging.campaigns.after or paging.adSets.after of a previous response. Requires level (and on TikTok the same limit).

Response

Live campaigns and ad sets

adAccountId
string
adSets
object[]

Absent when level=campaign.

campaigns
object[]

Absent when level=adSet.

connectionId
string | null

The ads connection (adc_...) the object belongs to.

currency
string

ISO 4217 code every budget and bid amount is expressed in.

paging
object

One entry per level read. after is null on the last page.

platform
enum<string>
Available options:
facebook,
tiktok
readAt
string<date-time>

When the platform was read.