List Google Ads invoices

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

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

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": "68b1c0d4e7b91d003c45a1f6",
    "invoice_date": "2026-08-25",
    "period_start": "2026-08-18",
    "period_end": "2026-08-24",
    "status": "PAID",
    "currency_code": "EUR",
    "ad_spend_micros": 248000000,
    "service_fee_micros": 24800000,
    "tax_micros": 51870000,
    "total_micros": 324670000,
    "is_refund": false,
    "signed_total_micros": 324670000,
    "billing_type": "weekly"
  }
]

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

Billing

List Google Ads invoices

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

Returns the billing invoices for the app’s Google Ads account, newest first.

Each invoice covers a period and carries the ad spend, the service fee, the tax and the total, all in micros of the invoice currency. billing_type says why it was raised: on the weekly cycle, because spend crossed the account’s threshold, or as a reconciliation of an earlier period.

A refund appears here as a row with is_refund: true, and its total_micros is a positive magnitude like any other row. Use signed_total_micros, which is negative on a refund, whenever you total an account’s billing. Summing total_micros counts a refund as a charge.

An invoice Base44 is still reconciling locally is left out until it settles, so a period can be missing for a short while after it ends.

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

invoices

List Google Ads invoices

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

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

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": "68b1c0d4e7b91d003c45a1f6",
    "invoice_date": "2026-08-25",
    "period_start": "2026-08-18",
    "period_end": "2026-08-24",
    "status": "PAID",
    "currency_code": "EUR",
    "ad_spend_micros": 248000000,
    "service_fee_micros": 24800000,
    "tax_micros": 51870000,
    "total_micros": 324670000,
    "is_refund": false,
    "signed_total_micros": 324670000,
    "billing_type": "weekly"
  }
]

{
  "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.

Response

The account's invoices, newest first.

string

required

ID of the invoice.

Example:

"68b1c0d4e7b91d003c45a1f6"

invoice_date

string

required

Date the invoice was issued, as YYYY-MM-DD.

Example:

"2026-08-25"

period_start

string

required

First day the invoice covers, as YYYY-MM-DD.

Example:

"2026-08-18"

period_end

string

required

Last day the invoice covers, as YYYY-MM-DD.

Example:

"2026-08-24"

status

string

required

PENDING, PAID, FAILED, or VOID.

Example:

"PAID"

currency_code

string

required

Currency of every amount on the invoice, as an ISO 4217 code.

Example:

"EUR"

ad_spend_micros

integer

required

Ad spend for the period in micros, so 248000000 is 248.00.

Example:

248000000

service_fee_micros

integer

required

Base44's service fee for the period, in micros.

Example:

24800000

tax_micros

integer

required

Tax charged on the invoice, in micros.

Example:

51870000

total_micros

integer

required

Size of the invoice in micros, always positive. On a refund this is the magnitude refunded rather than an amount charged, so read signed_total_micros or is_refund before treating it as money owed.

Example:

324670000

is_refund

boolean

required

true when the row is a refund rather than a charge.

Example:

false

signed_total_micros

integer

required

The invoice total with its direction applied: positive on a charge, negative on a refund. Sum this rather than total_micros when you total an account's billing.

Example:

324670000

billing_type

string

required

Why the invoice was raised: weekly on the billing cycle, threshold when spend crossed the cap, reconciliation to true up an earlier period.

Example:

"weekly"

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

Authorizations

Path Parameters

Response