List Google Ads promotional credits

curl --request GET \
  --url https://app.base44.com/api/apps/{app_id}/google-ads/billing/credits \
  --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/credits', 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/credits",
  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/credits"

	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/credits")

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

[
  {
    "id": "68b1c0d4e7b91d003c45a1f7",
    "code": "WELCOME50",
    "credit_type": "GOOGLE_PROMO",
    "status": "ACTIVE",
    "currency_code": "EUR",
    "amount_micros": 50000000,
    "used_micros": 12000000,
    "spendable": true,
    "expires_at": "2026-12-31T23:59:59Z"
  }
]

{
  "detail": [
    {
      "loc": [
        "<string>"
      ],
      "msg": "<string>",
      "type": "<string>"
    }
  ]
}

Billing

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.

GET

api

apps

{app_id}

google-ads

billing

credits

List Google Ads promotional credits

curl --request GET \
  --url https://app.base44.com/api/apps/{app_id}/google-ads/billing/credits \
  --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/credits', 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/credits",
  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/credits"

	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/credits")

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

[
  {
    "id": "68b1c0d4e7b91d003c45a1f7",
    "code": "WELCOME50",
    "credit_type": "GOOGLE_PROMO",
    "status": "ACTIVE",
    "currency_code": "EUR",
    "amount_micros": 50000000,
    "used_micros": 12000000,
    "spendable": true,
    "expires_at": "2026-12-31T23:59:59Z"
  }
]

{
  "detail": [
    {
      "loc": [
        "<string>"
      ],
      "msg": "<string>",
      "type": "<string>"
    }
  ]
}

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.

Query Parameters

include_settled

boolean

default:false

Response

The account's promotional credits.

string

required

ID of the credit.

Example:

"68b1c0d4e7b91d003c45a1f7"

code

string

required

Code the credit was granted under. Empty on a credit Base44 granted directly.

Example:

"WELCOME50"

credit_type

string

required

GOOGLE_PROMO for a Google Ads promotional credit, PLATFORM_CREDIT for one Base44 granted.

Example:

"GOOGLE_PROMO"

status

string

required

ACTIVE, USED, or EXPIRED.

Example:

"ACTIVE"

currency_code

string

required

Currency of the amounts, as an ISO 4217 code.

Example:

"EUR"

amount_micros

integer

required

Face value of the credit in micros, so 50000000 is 50.00.

Example:

50000000

used_micros

integer

required

How much of it has been spent, in micros.

Example:

12000000

spendable

boolean

required

true when the credit can still be spent. Rows returned only because you passed include_settled=true report false.

Example:

true

expires_at

string<date-time> | null

When the credit expires. null on a credit that does not expire.

Example:

"2026-12-31T23:59:59Z"

⌘I

App Management API (Beta)

Entities API (Beta)

Virality API (Beta)

Analytics API (Beta)

Google Ads API (Beta)

Monitoring API

Audit Logs API

List Google Ads promotional credits

Authorizations

Path Parameters

Query Parameters

Response