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

# List Google Ads promotional credits

`GET /api/apps/{app_id}/google-ads/billing/credits`

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

Returns the promotional credits on the app's Google Ads account.

Each credit carries its face value in `amount_micros` and how much has been spent in `used_micros`, both in micros of the credit currency. Subtract one from the other for what is left.

By default only credits that can still be spent are returned. Pass `include_settled=true` to also get recently used or expired ones, which come back with `spendable: false`. If you sum credits, filter on `spendable` rather than adding every row.

<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

- `include_settled` boolean

## Response `200`

Successful Response

- PromotionalCreditSummary[]
  - `id` string, required — ID of the credit.
  - `code` string, required — Code the credit was granted under. Empty on a credit Base44 granted directly.
  - `credit_type` string, required — Where the credit came from. A value of `GOOGLE_PROMO` is a Google Ads promotional credit, and `PLATFORM_CREDIT` is one Base44 granted.
  - `status` string, required — State of the credit. Either `ACTIVE`, `USED`, or `EXPIRED`.
  - `currency_code` string, required — Currency of the amounts, as an ISO 4217 code.
  - `amount_micros` integer, required — Face value of the credit in micros, so `50000000` is 50.00.
  - `used_micros` integer, required — How much of it has been spent, in micros.
  - `expires_at` string, date-time, nullable — When the credit expires, or `null` on a credit that does not expire.
  - `spendable` boolean, required — Whether the credit can still be spent. Rows returned only because you passed `include_settled=true` report `false`.

## Other responses

- `401` — Missing or invalid credentials.
- `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` — The app has no connected Google Ads account.
- `422` — Validation Error

---

[API](https://skmtc.dev/base44/apis/base44-app-management-api.md) · [All operations](https://skmtc.dev/base44/apis/base44-app-management-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/base44/base44-app-management-api/revisions/173e4e9c63c2/schema)