Join us live on
Discord on the Google Advertising and Measurement Community server and on
YouTube on January 29th at 10:00 AM EST! We will discuss the new features added in v23 of the Google Ads API.
ListInvoicesRequest
Stay organized with collections
Save and categorize content based on your preferences.
Request message for fetching the invoices of a given billing setup that were issued during a given month.
codeProto definition
| Fields |
billing_setup
|
string
Required. The billing setup resource name of the requested invoices. customers/{customer_id}/billingSetups/{billing_setup_id}
|
customer_id
|
string
Required. The ID of the customer to fetch invoices for.
|
include_granular_level_invoice_details
|
bool
Optional. When true, the response will include more granular level invoice details such as campaign level cost breakdown, itemized regulatory costs and adjustments. The default value is false.
|
issue_month
|
MonthOfYear
Required. The issue month to retrieve invoices.
|
issue_year
|
string
Required. The issue year to retrieve invoices, in yyyy format. Only invoices issued in 2019 or later can be retrieved.
|
Except as otherwise noted, the content of this page is licensed under the Creative Commons Attribution 4.0 License, and code samples are licensed under the Apache 2.0 License. For details, see the Google Developers Site Policies. Java is a registered trademark of Oracle and/or its affiliates.
Last updated 2026-01-22 UTC.
[null,null,["Last updated 2026-01-22 UTC."],[],[]]