> ## 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 promotional credits
> This API is in beta. Endpoints, fields, and behavior may still change, so avoid depending on it in production.
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 you can still spend 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.
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/billing/credits
openapi: 3.1.0
info:
title: Base44 App Management API
version: 1.0.0
servers:
- url: https://app.base44.com
security:
- ApiKeyAuth: []
paths:
/api/apps/{app_id}/google-ads/billing/credits:
get:
summary: List Google Ads promotional credits
description: >-
This API is in beta. Endpoints, fields, and behavior may still
change, so avoid depending on it in production.
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 you can still spend 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.
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_credits_api_apps__app_id__google_ads_billing_credits_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: include_settled
in: query
required: false
schema:
type: boolean
default: false
title: Include Settled
responses:
'200':
description: The account's promotional credits.
content:
application/json:
schema:
type: array
items:
$ref: '#/components/schemas/PromotionalCreditSummary'
title: >-
Response 200 List Credits Api Apps App Id Google Ads Billing
Credits Get
'401':
description: Missing or invalid credentials.
'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: The app has no connected Google Ads account.
'422':
description: Validation Error
content:
application/json:
schema:
$ref: '#/components/schemas/HTTPValidationError'
components:
schemas:
PromotionalCreditSummary:
properties:
id:
type: string
title: Id
description: ID of the credit.
example: 68b1c0d4e7b91d003c45a1f7
code:
type: string
title: Code
description: >-
Code the credit was granted under. Empty on a credit Base44 granted
directly.
example: WELCOME50
credit_type:
type: string
title: Credit Type
description: >-
`GOOGLE_PROMO` for a Google Ads promotional credit,
`PLATFORM_CREDIT` for one Base44 granted.
example: GOOGLE_PROMO
status:
type: string
title: Status
description: '`ACTIVE`, `USED`, or `EXPIRED`.'
example: ACTIVE
currency_code:
type: string
title: Currency Code
description: Currency of the amounts, as an ISO 4217 code.
example: EUR
amount_micros:
type: integer
title: Amount Micros
description: Face value of the credit in micros, so `50000000` is 50.00.
example: 50000000
used_micros:
type: integer
title: Used Micros
description: How much of it has been spent, in micros.
example: 12000000
expires_at:
anyOf:
- type: string
format: date-time
- type: 'null'
title: Expires At
description: When the credit expires. `null` on a credit that does not expire.
example: '2026-12-31T23:59:59Z'
spendable:
type: boolean
title: Spendable
description: >-
`true` when the credit can still be spent. Rows returned only
because you passed `include_settled=true` report `false`.
example: true
type: object
required:
- id
- code
- credit_type
- status
- currency_code
- amount_micros
- used_micros
- spendable
title: PromotionalCreditSummary
description: One promotional credit on the app's Google Ads account.
HTTPValidationError:
properties:
detail:
items:
$ref: '#/components/schemas/ValidationError'
type: array
title: Detail
type: object
title: HTTPValidationError
ValidationError:
properties:
loc:
items:
anyOf:
- type: string
- type: integer
type: array
title: Location
msg:
type: string
title: Message
type:
type: string
title: Error Type
type: object
required:
- loc
- msg
- type
title: ValidationError
securitySchemes:
ApiKeyAuth:
type: apiKey
in: header
name: api_key
description: Personal API key.
````