Skip to main content
GET
List ad accounts

Request contract

  • Method and path: GET /apis/v1/ads/accounts
  • Availability: enabled
  • Request URL template: https://api.aisa.one/apis/v1/ads/accounts
  • connectionId: query; required
  • adAccountId: query; optional
  • limit: query; optional
  • inScopeOnly: 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

Filter response to a single platform ad account ID (e.g. act_123 for Meta, advertiser_id for TikTok). Returns at most one item.

limit
integer

Clamp the returned accounts[] length. Useful for typeahead pickers on agency tokens with hundreds of advertisers.

Required range: 1 <= x <= 1000
inScopeOnly
boolean
default:false

true returns only the ad accounts this connection accepts as adAccountId on the other /apis/v1/ads endpoints, i.e. those inside its ad-account selection (every item then has selected: true).

Response

Ad accounts

accounts
object[]
cachedAt
string<date-time> | null

Google only. When this list was fetched from Google. Null when it was never served from cache. Absent on other platforms.

stale
boolean

Google only. True when Google's daily API quota was exhausted and this is the last successful fetch, not a live read. Absent on other platforms.