Skip to main content
POST
Preview an ad rule

Request contract

  • Method and path: POST /apis/v1/ads/rules/{ruleId}/preview
  • Availability: enabled
  • Request URL template: https://api.aisa.one/apis/v1/ads/rules/{ruleId}/preview
  • ruleId: path; required
  • connectionId: query; required
  • 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.

Path Parameters

ruleId
string
required

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]+$

Body

application/json
connectionId
string

The ads connection, when not sent as a query parameter.

Response

Evaluation

currency
string | null
required
evaluatedAt
string<date-time>
required
matched
integer
required

How many objects meet every condition.

objects
object[]
required

Every delivering campaign or ad set in scope (for an activate rule, the rule-paused ones it may reactivate).

timezone
string
required

IANA timezone of the ad account.

timezoneAssumed
boolean
required

True when the ad account has no known timezone and UTC was assumed.

today
string<date>
required

The ad account's calendar date the windows were resolved against.