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

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

200

[
  {
    "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"
  }
]

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

200

application/json

Successful Response

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

State of the invoice. Either 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

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