> ## Documentation Index > Fetch the complete documentation index at: https://docs.base44.com/llms.txt > Use this file to discover all available pages before exploring further. # List Google Ads incentives > This API is in beta. Endpoints, fields, and behavior may still change, so avoid depending on it in production. 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). This endpoint accepts a personal API key. Workspace API keys are not authorized for it and are rejected with a 403. The response includes fields beyond the ones documented here. Don't rely on undocumented response fields, as they can change at any time. ## OpenAPI ````yaml /developers/references/app-management/app-management-openapi.json get /api/apps/{app_id}/google-ads/incentives openapi: 3.1.0 info: title: Base44 App Management API version: 1.0.0 servers: - url: https://app.base44.com security: - PersonalAccessTokenAuth: [] paths: /api/apps/{app_id}/google-ads/incentives: get: summary: List Google Ads incentives description: >- This API is in beta. Endpoints, fields, and behavior may still change, so avoid depending on it in production. 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). This endpoint accepts a personal API key. Workspace API keys are not authorized for it and are rejected with a 403. The response includes fields beyond the ones documented here. Don't rely on undocumented response fields, as they can change at any time. operationId: list_incentives_api_apps__app_id__google_ads_incentives_get parameters: - name: app_id in: path required: true schema: type: string description: ID of the app whose Google Ads campaigns to manage. title: App Id description: ID of the app whose Google Ads campaigns to manage. example: 6820f3a4e7b91d003c45a1f2 - name: account_id in: query required: false schema: type: string description: >- 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. default: '' title: Account Id description: >- 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. example: 68b1c0d4e7b91d003c45a1f8 responses: '200': description: The offers you can apply, or an empty list when there are none. content: application/json: schema: type: array items: $ref: '#/components/schemas/GoogleAdsIncentiveOffer' title: >- Response 200 List Incentives Api Apps App Id Google Ads Incentives Get '400': description: >- Google Ads rejected the request. The response message carries Google's reason. '401': description: >- Missing or invalid credentials, or the calling user has no email address to look offers up by. '403': description: >- 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': description: No account with this `account_id` belongs to this app. '429': description: Google Ads is rate limiting the account. Retry later. components: schemas: GoogleAdsIncentiveOffer: properties: id: type: string title: Id description: Google's ID for the offer. example: '1234567' code: type: string title: Code description: >- 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. example: SELECTED:1234567:USD currency_code: type: string title: Currency Code description: >- 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`. example: USD approximate: type: boolean title: Approximate description: >- 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. example: false reward_amount_micros: type: integer title: Reward Amount Micros description: >- Ad credit Google grants once the spend requirement is met, in micros of `currency_code`, so `500000000` is 500.00. example: 500000000 required_min_spend_micros: type: integer title: Required Min Spend Micros description: >- Ad spend the account has to reach to earn the reward, in micros of `currency_code`. example: 500000000 terms_url: type: string title: Terms Url description: >- Google's terms and conditions for the offer. Empty when Google didn't return a link. example: https://ads.google.com/intl/en/home/terms-and-conditions/incentives/ type: object required: - id - code - currency_code - approximate - reward_amount_micros - required_min_spend_micros - terms_url title: GoogleAdsIncentiveOffer description: One promotional offer the app's Google Ads account can take. securitySchemes: PersonalAccessTokenAuth: type: http scheme: bearer description: 'Personal access token, sent as `Authorization: Bearer `.' ````