ads
GET /v1/ads/connections/{connection_id}/budget-decisions
The customer's own budget decisions on this Google Ads account (za-84).
Authentication
Send an API key as a bearer token. The key must carry the ads.view permission; a key without it is refused with 403, not 404.
This endpoint takes no organisation id. Your key already identifies the organisation it belongs to, and the response is scoped to it.
Try it
Replace anything in angle brackets with your own values, and the key placeholder with a key from your dashboard.
curl -X GET https://api.zinndigital.com/v1/ads/connections/{connection_id}/budget-decisions \
-H "Authorization: Bearer zdk_live_…"Signed in? The API console in your dashboard fills in your real organisation id and your own key, and runs the request against the live API so you can see the actual response. Open this endpoint in the API console
Details
Gated on ads.view. Every decision in force (active, or awaiting — a dated test past its end date waiting for the customer's answer), dated ahead (pending), or ended in the last 30 days. Each carries the amount a day and the amount before (integer micros of the account's currency, currency), the customer's reason verbatim, who decided and when, the figures since it started against the same number of days before it, live_micros (the budget the latest audit saw) with drifted when it no longer matches (changed outside — reported, never changed back), and held_back (how many automatic budget changes the decision refused). Our own rows only — never a network call (docs/1006 §84).
Parameters
| Name | Type | Required | What it is |
|---|---|---|---|
connection_id (path) | string | Yes | — |
Response
| Name | Type | Required | What it is |
|---|---|---|---|
currency | string | Yes | The account's ISO 4217 currency. |
time_zone | string | Yes | ACCTTZ (docs/1006 §84) — the Google Ads account's own time zone (IANA name, Google's customer.time_zone, refreshed on every sync). Every date in this list (starts_on, ends_on) is… |
campaigns | object[] | Yes | The campaigns a person can pick (those the daily audit stored figures for lately). |
data | AdsBudgetDecision[] | Yes | — |
Errors this endpoint can return
401 · 403 · 404 · 429