List Google Ads invoices

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

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.

<Warning>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.</Warning>

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.

<Note>This endpoint accepts a personal API key. Workspace API keys are not authorized for it and are rejected with a 403.</Note>

<Warning>The response includes fields beyond the ones documented here. Don't rely on undocumented response fields, as they can change at any time.</Warning>

get/api/apps/{app_id}/google-ads/billing/invoices

Path parameters

app_idstring required

ID of the app whose Google Ads campaigns to manage.

Response

Successful Response

idstring required

ID of the invoice.

invoice_datestring required

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

period_startstring required

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

period_endstring required

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

statusstring required

State of the invoice. Either PENDING, PAID, FAILED, or VOID.

currency_codestring required

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

ad_spend_microsinteger required

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

service_fee_microsinteger required

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

tax_microsinteger required

Tax charged on the invoice, in micros.

total_microsinteger 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.

is_refundboolean required

Whether the row is a refund rather than a charge.

signed_total_microsinteger 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.

billing_typestring 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 response

[
  {
    "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,
    "signed_total_micros": 324670000,
    "billing_type": "weekly"
  }
]

Changes

No recorded changes to this endpoint across all 1 revision of this API.