Get Google Ads workspace debt

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

import requests

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

headers = {"api_key": "<api-key>"}

response = requests.get(url, headers=headers)

print(response.text)

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

fetch('https://app.base44.com/api/apps/{app_id}/google-ads/billing/workspace-debt', 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/workspace-debt",
  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/workspace-debt"

	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/workspace-debt")

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

{
  "state": "payable",
  "recoverable": true,
  "can_pay_now": true,
  "requires_payment_method": false,
  "stripe_unavailable": false,
  "account_id": "68b1c0d4e7b91d003c45a1f8",
  "app_id": "6820f3a4e7b91d003c45a1f2",
  "account_status": "BLOCKED",
  "block_reason": "PAYMENT_FAILED",
  "charge_trigger_mode": "cadence",
  "payment_method": {
    "brand": "visa",
    "last4": "4242"
  },
  "invoice": {
    "id": "68b1c0d4e7b91d003c45a1fa",
    "status": "FAILED",
    "billing_type": "weekly",
    "period_start": "2026-08-18",
    "period_end": "2026-08-24",
    "amount_micros": 43500000,
    "currency_code": "USD",
    "failed_at": "2026-08-25T04:12:00Z"
  }
}

Billing

Get Google Ads workspace debt

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

Returns what the workspace owes for Google Ads spend, and whether it can be settled.

The balance is workspace-wide rather than per app. Base44 holds Google Ads at the workspace level, so this resolves the held account across every app in the workspace and reports it from whichever app you ask through. That is why app_id in the response can name a different app from the one in the path. Read state first, since no_workspace_debt is the normal answer and leaves every other field at a neutral default rather than omitting it.

Nothing here charges anything. Settling a balance is a card transaction Base44 deliberately keeps out of this API, so treat a payable state as something to raise with whoever owns the card.

Unlike the rest of the Google Ads API, this endpoint stays available while Google Ads is switched off for you, so a workspace can always see what it owes.

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

workspace-debt

Get Google Ads workspace debt

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

import requests

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

headers = {"api_key": "<api-key>"}

response = requests.get(url, headers=headers)

print(response.text)

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

fetch('https://app.base44.com/api/apps/{app_id}/google-ads/billing/workspace-debt', 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/workspace-debt",
  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/workspace-debt"

	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/workspace-debt")

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

{
  "state": "payable",
  "recoverable": true,
  "can_pay_now": true,
  "requires_payment_method": false,
  "stripe_unavailable": false,
  "account_id": "68b1c0d4e7b91d003c45a1f8",
  "app_id": "6820f3a4e7b91d003c45a1f2",
  "account_status": "BLOCKED",
  "block_reason": "PAYMENT_FAILED",
  "charge_trigger_mode": "cadence",
  "payment_method": {
    "brand": "visa",
    "last4": "4242"
  },
  "invoice": {
    "id": "68b1c0d4e7b91d003c45a1fa",
    "status": "FAILED",
    "billing_type": "weekly",
    "period_start": "2026-08-18",
    "period_end": "2026-08-24",
    "amount_micros": 43500000,
    "currency_code": "USD",
    "failed_at": "2026-08-25T04:12:00Z"
  }
}

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

What the workspace owes, and whether it can be settled.

Whether the workspace owes anything for Google Ads spend.

state

string

required

What can be done about the balance. no_workspace_debt means nothing is held. payable means there is an invoice and a usable card. requires_payment_method and requires_payment_refresh both mean a card is needed. pending_payment means a charge is already in flight. paid_recovery_incomplete means the invoice is paid but the account is still held. unavailable means the balance cannot be settled right now, including when stripe_unavailable is true. no_debt and not_recoverable mean the account has no settleable balance.

Example:

"payable"

recoverable

boolean

required

Whether the account is in a state Base44 can settle at all (true) or not (false).

Example:

true

can_pay_now

boolean

required

Whether there is a chargeable invoice and a usable card, so settling would go through now (true) or not (false).

Example:

true

requires_payment_method

boolean

required

Whether a card has to be added or replaced before the balance can be settled (true) or not (false).

Example:

false

stripe_unavailable

boolean

required

Whether Base44 could not reach the payment provider (true) or reached it fine (false). When it is true the card check failed closed, so payment_method reads null and can_pay_now reads false because the check failed, not because the card is missing. Retry rather than telling someone to add a card.

Example:

false

account_id

string | null

ID of the Google Ads account the balance belongs to, or null when state is no_workspace_debt.

Example:

"68b1c0d4e7b91d003c45a1f8"

app_id

string | null

ID of the app that owns the held account, which is not necessarily the app in the path. The value is null when state is no_workspace_debt.

Example:

"6820f3a4e7b91d003c45a1f2"

account_status

string | null

Status of the held Google Ads account, or null when state is no_workspace_debt.

Example:

"BLOCKED"

block_reason

string | null

Why the account is held, or null when it is not held or the reason is unrecorded.

Example:

"PAYMENT_FAILED"

charge_trigger_mode

string | null

How the account is billed. cadence is the recurring charge and threshold is spend-triggered. The value is null when state is no_workspace_debt.

Example:

"cadence"

payment_method

WorkspaceDebtPaymentMethod · object | null

The card on file, or null when the workspace has none and when the payment provider could not be reached.

Show child attributes

invoice

WorkspaceDebtInvoice · object | null

The unpaid invoice behind the hold, or null when there is none to settle and when the latest one is already paid.

Show child attributes

App Management API (Beta)

Entities API (Beta)

Virality API (Beta)

Workflows API (Beta)

Analytics API (Beta)

Google Ads API (Beta)

Monitoring API

Audit Logs API

Get Google Ads workspace debt

Authorizations

Path Parameters

Response