Sign in

Get Google Ads billing status

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

Reports whether the workspace can be charged for ad spend, and shows the card on file.

Read this before creating or resuming a campaign, both of which need a usable card.

<Warning>The check fails closed. When Base44 cannot reach the payment provider it returns has_payment_method: false with stripe_unavailable: true, which means "could not check" rather than "no card". Retry in that case instead of telling someone to add a card.</Warning>

<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>

get/api/apps/{app_id}/google-ads/billing/status

Path parameters

app_idstring required

ID of the app whose Google Ads campaigns to manage.

ID of the app whose Google Ads campaigns to manage.

Response

Successful Response

has_payment_methodboolean required

Whether a usable card is on file. Read it together with stripe_unavailable, which changes what a false means.

stripe_unavailableboolean required

Whether Base44 could not reach the payment provider. When it is true, has_payment_method reports false because the check fails closed, not because the card is missing. Retry rather than telling someone to add a card.

currency_codestring nullable

Currency the workspace is billed in, as an ISO 4217 code, or null before a card is on file.

payment_method_brandstring required

Card brand, for display. Empty when no card is on file.

payment_method_last4string nullable

Last four digits of the card, for display, or null when no card is on file.

Example response

{
  "has_payment_method": true,
  "currency_code": "EUR",
  "payment_method_brand": "visa",
  "payment_method_last4": "4242"
}

Changes

Changed in 2 of the 11 revisions of this API.2