Get Google Ads billing status

curl --request GET \
  --url https://app.base44.com/api/apps/{app_id}/google-ads/billing/status \
  --header 'api_key: <api-key>'

const options = {method: 'GET', headers: {api_key: '<api-key>'}};

fetch('https://app.base44.com/api/apps/{app_id}/google-ads/billing/status', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://app.base44.com/api/apps/{app_id}/google-ads/billing/status",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "api_key: <api-key>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://app.base44.com/api/apps/{app_id}/google-ads/billing/status"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("api_key", "<api-key>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://app.base44.com/api/apps/{app_id}/google-ads/billing/status")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["api_key"] = '<api-key>'

response = http.request(request)
puts response.read_body

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

Billing

Get Google Ads billing status

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

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.

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.

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.

GET

api

apps

{app_id}

google-ads

billing

status

Get Google Ads billing status

curl --request GET \
  --url https://app.base44.com/api/apps/{app_id}/google-ads/billing/status \
  --header 'api_key: <api-key>'

const options = {method: 'GET', headers: {api_key: '<api-key>'}};

fetch('https://app.base44.com/api/apps/{app_id}/google-ads/billing/status', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://app.base44.com/api/apps/{app_id}/google-ads/billing/status",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "api_key: <api-key>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://app.base44.com/api/apps/{app_id}/google-ads/billing/status"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("api_key", "<api-key>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://app.base44.com/api/apps/{app_id}/google-ads/billing/status")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["api_key"] = '<api-key>'

response = http.request(request)
puts response.read_body

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

Authorizations

api_key

string

header

required

Personal API key.

Path Parameters

app_id

string

required

ID of the app whose Google Ads campaigns to manage.

Response

Successful Response

Whether the workspace can be charged for ad spend.

has_payment_method

boolean

required

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

Example:

true

stripe_unavailable

boolean

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.

Example:

false

payment_method_brand

string

required

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

Example:

"visa"

currency_code

string | null

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

Example:

"EUR"

payment_method_last4

string | null

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

Example:

"4242"

Base44 APIs

Apps API (Beta)

Monitoring API

Audit Logs API

Get Google Ads billing status

Authorizations

Path Parameters

Response