---
title: "List Google Ads incentives"
method: GET
path: "/api/apps/{app_id}/google-ads/incentives"
---

# List Google Ads incentives

`GET /api/apps/{app_id}/google-ads/incentives`

<Info>This API is in beta. Endpoints, fields, and behavior may still change, so avoid depending on it in production.</Info>

Returns the promotional offers Google Ads has for the app's account. Each one grants ad credit once the account's spend reaches a set amount.

The offers are personal to you. Google picks them from your email address, so another member of the workspace can see different ones.

Pass `account_id` once the app has a Google Ads account, so the offers are quoted in its currency. Before then, leave it out and the offers are quoted in the currency a new account would be created in, which depends on where the request comes from. If the account ends up in a different currency, applying an offer read that way is rejected.

An empty list is a normal answer. It comes back when the account already holds an incentive, when incentives aren't offered in the account's currency, which today means anything other than `USD` or `ILS`, and when Google has nothing for you.

Take an offer with [Apply a Google Ads incentive](/api-reference/apply-a-google-ads-incentive).

<Note>This endpoint accepts a personal API key. Workspace API keys are not authorized for it and are rejected with a 403.</Note>

<Warning>The response includes fields beyond the ones documented here. Don't rely on undocumented response fields, as they can change at any time.</Warning>

## Path parameters

- `app_id` string, required — ID of the app whose Google Ads campaigns to manage.

## Query parameters

- `account_id` string — ID of the app's Google Ads account, as returned in `id` by [Get Google Ads account](/api-reference/get-google-ads-account). Leave it out before the app has an account. Defaults to empty, which quotes the offers for a new account.

## Response `200`

The offers you can apply, or an empty list when there are none.

- GoogleAdsIncentiveOffer[]
  - `id` string, required — Google's ID for the offer.
  - `code` string, required — Token to send as `coupon_code` to [Apply a Google Ads incentive](/api-reference/apply-a-google-ads-incentive). Treat it as opaque. It's bound to the currency the offer was quoted in.
  - `currency_code` string, required — Currency of `reward_amount_micros` and `required_min_spend_micros`, as an ISO 4217 code. It's the account's currency, or the currency a new account would be created in when you left out `account_id`.
  - `approximate` boolean, required — Whether the amounts were converted from the currency Google quoted the offer in (`true`) or are Google's own figures (`false`). Google converts again at its own rate when it grants the reward, so a converted amount can differ slightly from the credit granted.
  - `reward_amount_micros` integer, required — Ad credit Google grants once the spend requirement is met, in micros of `currency_code`, so `500000000` is 500.00.
  - `required_min_spend_micros` integer, required — Ad spend the account has to reach to earn the reward, in micros of `currency_code`.
  - `terms_url` string, required — Google's terms and conditions for the offer. Empty when Google didn't return a link.

## Other responses

- `400` — Google Ads rejected the request. The response message carries Google's reason.
- `401` — Missing or invalid credentials, or the calling user has no email address to look offers up by.
- `403` — You don't have access to this app, the app does not exist, or you used a workspace API key. A missing app and an app you cannot reach are deliberately the same answer.
- `404` — No account with this `account_id` belongs to this app.
- `429` — Google Ads is rate limiting the account. Retry later.

## Changes

> 18 revisions in range; 1 not diffed.

- **2026-09-28** `28fc82924122` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/adexad/apis/base44-app-management-api/changes/api/apps/:app_id/google-ads/incentives/get.md)

---

[API](https://skmtc.dev/adexad/apis/base44-app-management-api.md) · [All operations](https://skmtc.dev/adexad/apis/base44-app-management-api/llms.txt) · [OpenAPI document](https://skmtc.dev/adexad/apis/base44-app-management-api/revisions/28fc82924122?raw)