--- title: "GET /v23/customers/{customersId}/invoices" method: GET path: "/v23/customers/{customersId}/invoices" tags: ["customers"] --- # GET /v23/customers/{customersId}/invoices `GET /v23/customers/{customersId}/invoices` ## Request - Base URL: `https://searchads360.googleapis.com` - URL: `https://searchads360.googleapis.com/v23/customers/{customersId}/invoices` - Auth: OAuth 2 and OAuth 2 - Implicit: `https://accounts.google.com/o/oauth2/auth` - Scopes: `https://www.googleapis.com/auth/doubleclicksearch` - Authorization code: `https://accounts.google.com/o/oauth2/auth` - Token URL: `https://accounts.google.com/o/oauth2/token` scopes: `https://www.googleapis.com/auth/doubleclicksearch` - TypeScript: (a function with typed inputs; its response is checked against the schema) Returns all invoices associated with a billing setup, for a given month. List of thrown errors: [AuthenticationError]() [AuthorizationError]() [FieldError]() [HeaderError]() [InternalError]() [InvoiceError]() [QuotaError]() [RequestError]() ## Path parameters - `customersId` string, required ## Query parameters - `billingSetup` string - `includeGranularLevelInvoiceDetails` boolean - `issueMonth` 'UNSPECIFIED' | 'UNKNOWN' | 'JANUARY' | 'FEBRUARY' | 'MARCH' | 'APRIL' | 'MAY' | 'JUNE' | 'JULY' | 'AUGUST' | 'SEPTEMBER' | 'OCTOBER' | 'NOVEMBER' | 'DECEMBER' - `issueYear` string ## Response `200` Successful response - GoogleAdsSearchads360V23ServicesListInvoicesResponse: Response message for InvoiceService.ListInvoices. - `invoices` GoogleAdsSearchads360V23ResourcesInvoice[]: The list of invoices that match the billing setup and time period. - `accountBudgetSummaries` GoogleAdsSearchads360V23ResourcesInvoiceAccountBudgetSummary[]: Output only. The list of summarized account budget information associated with this invoice. - `accountBudget` string: Output only. The resource name of the account budget associated with this summarized billable cost. AccountBudget resource names have the form: `customers/{customer_id}/accountBudgets/{account_budget_id}` - `accountBudgetName` string: Output only. The name of the account budget. It appears on the invoice PDF as "Account budget". - `billableActivityDateRange` GoogleAdsSearchads360V23CommonDateRange: A date range. - `endDate` string: The end date, in yyyy-mm-dd format. This date is inclusive. - `startDate` string: The start date, in yyyy-mm-dd format. This date is inclusive. - `billedAmountMicros` string, int64: Output only. The pretax billed amount attributable to this budget during the service period, in micros. This does not account for any adjustments. - `campaignSummaries` GoogleAdsSearchads360V23ResourcesInvoiceCampaignSummary[]: Output only. The list of summarized campaign level information associated with this account budget. - `amountMicros` string, int64: Output only. The amount attributable to this campaign for the given unit of measure during the service period, in micros. The currency code for this amount is the same as the Invoice.currency_code. - `campaignDescription` string: Output only. The description of the campaign. This is generally the same as the campaign name, but may differ. - `quantity` string, int64: Output only. The quantity served for the given unit of measure. - `unitOfMeasure` 'UNSPECIFIED' | 'UNKNOWN' | 'CLICKS' | 'IMPRESSIONS' | 'ACQUISITIONS' | 'PHONE_CALLS' | 'VIDEO_PLAYS' | 'DAYS' | 'AUDIO_PLAYS' | 'ENGAGEMENTS' | 'SECONDS' | 'LEADS' | 'GUEST_STAYS' | 'HOURS': Output only. The unit of measure for the quantity served. - `customer` string: Output only. The resource name of the customer associated with this account budget. This contains the customer ID, which appears on the invoice PDF as "Account ID". Customer resource names have the form: `customers/{customer_id}` - `customerDescriptiveName` string: Output only. The descriptive name of the account budget's customer. It appears on the invoice PDF as "Account". - `invalidActivityAmountMicros` string, int64: Output only. The pretax invalid activity amount attributable to this budget in previous months, in micros (negative value). - `invalidActivitySummaries` GoogleAdsSearchads360V23ResourcesInvoiceInvalidActivitySummary[]: Output only. The list of summarized invalid activity credits with original linkages. - `amountMicros` string, int64: Output only. Invalid activity amount in micros. - `originalAccountBudgetName` string: Output only. Original account budget name related to this invalid activity credit. - `originalInvoiceId` string: Output only. Original invoice number related to this invalid activity credit. - `originalMonthOfService` 'UNSPECIFIED' | 'UNKNOWN' | 'JANUARY' | 'FEBRUARY' | 'MARCH' | 'APRIL' | 'MAY' | 'JUNE' | 'JULY' | 'AUGUST' | 'SEPTEMBER' | 'OCTOBER' | 'NOVEMBER' | 'DECEMBER': Output only. Original month of service related to this invalid activity credit. - `originalPurchaseOrderNumber` string: Output only. Original purchase order number related to this invalid activity credit. - `originalYearOfService` string: Output only. Original year of service related to this invalid activity credit. - `overdeliveryAmountMicros` string, int64: Output only. The pretax overdelivery amount attributable to this budget during the service period, in micros (negative value). - `purchaseOrderNumber` string: Output only. The purchase order number of the account budget. It appears on the invoice PDF as "Purchase order". - `servedAmountMicros` string, int64: Output only. The pretax served amount attributable to this budget during the service period, in micros. This is only useful to reconcile invoice and delivery data. - `subtotalAmountMicros` string, int64: Output only. The pretax subtotal amount attributable to this budget during the service period, in micros. - `taxAmountMicros` string, int64: Output only. The tax amount attributable to this budget during the service period, in micros. - `totalAmountMicros` string, int64: Output only. The total amount attributable to this budget during the service period, in micros. This equals the sum of the account budget subtotal amount and the account budget tax amount. - `accountSummaries` GoogleAdsSearchads360V23ResourcesInvoiceAccountSummary[]: Output only. The list of summarized account information associated with this invoice. - `adjustmentSummaries` GoogleAdsSearchads360V23ResourcesInvoiceAdjustmentSummary[]: Output only. The list of adjustment information associated with this account. - `adjustmentDescription` string: Output only. The description of the adjustment. Example: Incentive Adjustment, discount. - `amountMicros` string, int64: Output only. The amount of the adjustment, in micros. The currency code for this amount is the same as the Invoice.currency_code. - `billingCorrectionSubtotalAmountMicros` string, int64: Output only. Pretax billing correction subtotal amount, in micros. - `billingCorrectionTaxAmountMicros` string, int64: Output only. Tax on billing correction, in micros. - `billingCorrectionTotalAmountMicros` string, int64: Output only. Total billing correction amount, in micros. - `couponAdjustmentSubtotalAmountMicros` string, int64: Output only. Pretax coupon adjustment subtotal amount, in micros. - `couponAdjustmentTaxAmountMicros` string, int64: Output only. Tax on coupon adjustment, in micros. - `couponAdjustmentTotalAmountMicros` string, int64: Output only. Total coupon adjustment amount, in micros. - `customer` string: Output only. The account associated with the account summary. - `excessCreditAdjustmentSubtotalAmountMicros` string, int64: Output only. Pretax excess credit adjustment subtotal amount, in micros. - `excessCreditAdjustmentTaxAmountMicros` string, int64: Output only. Tax on excess credit adjustment, in micros. - `excessCreditAdjustmentTotalAmountMicros` string, int64: Output only. Total excess credit adjustment amount, in micros. - `exportChargeSubtotalAmountMicros` string, int64: Output only. Pretax export charge subtotal amount, in micros. - `exportChargeTaxAmountMicros` string, int64: Output only. Tax on export charge, in micros. - `exportChargeTotalAmountMicros` string, int64: Output only. Total export charge amount, in micros. - `regulatoryCostSummaries` GoogleAdsSearchads360V23ResourcesInvoiceRegulatoryCostSummary[]: Output only. The list of regulatory cost information associated with this account. - `amountMicros` string, int64: Output only. The amount of the regulatory fee, in micros. The currency code for this amount is the same as the Invoice.currency_code. - `regulatoryFeeType` 'UNSPECIFIED' | 'UNKNOWN' | 'AUSTRIA_DST_FEE' | 'TURKIYE_REGULATORY_OPERATING_COST' | 'UK_DST_FEE' | 'SPAIN_REGULATORY_OPERATING_COST' | 'FRANCE_REGULATORY_OPERATING_COST' | 'ITALY_REGULATORY_OPERATING_COST' | 'INDIA_REGULATORY_OPERATING_COST' | 'POLAND_REGULATORY_OPERATING_COST' | 'OPERATING_CHARGES' | 'CANADA_DST_FEE': Output only. The type of regulatory fee. - `regulatoryCostsSubtotalAmountMicros` string, int64: Output only. Pretax regulatory costs subtotal amount, in micros. - `regulatoryCostsTaxAmountMicros` string, int64: Output only. Tax on regulatory costs, in micros. - `regulatoryCostsTotalAmountMicros` string, int64: Output only. Total regulatory costs amount, in micros. - `subtotalAmountMicros` string, int64: Output only. Total pretax subtotal amount attributable to the account during the service period, in micros. - `taxAmountMicros` string, int64: Output only. Total tax amount attributable to the account during the service period, in micros. - `totalAmountMicros` string, int64: Output only. Total amount attributable to the account during the service period, in micros. This equals the sum of the subtotal_amount_micros and tax_amount_micros. - `adjustmentsSubtotalAmountMicros` string, int64: Output only. The pretax subtotal amount of invoice level adjustments, in micros. - `adjustmentsTaxAmountMicros` string, int64: Output only. The sum of taxes on the invoice level adjustments, in micros. - `adjustmentsTotalAmountMicros` string, int64: Output only. The total amount of invoice level adjustments, in micros. - `billingSetup` string: Output only. The resource name of this invoice's billing setup. `customers/{customer_id}/billingSetups/{billing_setup_id}` - `correctedInvoice` string: Output only. The resource name of the original invoice corrected, wrote off, or canceled by this invoice, if applicable. If `corrected_invoice` is set, `replaced_invoices` will not be set. Invoice resource names have the form: `customers/{customer_id}/invoices/{invoice_id}` - `currencyCode` string: Output only. The currency code. All costs are returned in this currency. A subset of the currency codes derived from the ISO 4217 standard is supported. - `dueDate` string: Output only. The due date in yyyy-mm-dd format. - `exportChargeSubtotalAmountMicros` string, int64: Output only. The pretax subtotal amount of invoice level export charges, in micros. - `exportChargeTaxAmountMicros` string, int64: Output only. The sum of taxes on the invoice level export charges, in micros. - `exportChargeTotalAmountMicros` string, int64: Output only. The total amount of invoice level export charges, in micros. - `id` string: Output only. The ID of the invoice. It appears on the invoice PDF as "Invoice number". - `issueDate` string: Output only. The issue date in yyyy-mm-dd format. It appears on the invoice PDF as either "Issue date" or "Invoice date". - `paymentsAccountId` string: Output only. A 16 digit ID used to identify the payments account associated with the billing setup, for example, "1234-5678-9012-3456". It appears on the invoice PDF as "Billing Account Number". - `paymentsProfileId` string: Output only. A 12 digit ID used to identify the payments profile associated with the billing setup, for example, "1234-5678-9012". It appears on the invoice PDF as "Billing ID". - `pdfUrl` string: Output only. The URL to a PDF copy of the invoice. Users need to pass in their OAuth token to request the PDF with this URL. - `regulatoryCostsSubtotalAmountMicros` string, int64: Output only. The pretax subtotal amount of invoice level regulatory costs, in micros. - `regulatoryCostsTaxAmountMicros` string, int64: Output only. The sum of taxes on the invoice level regulatory costs, in micros. - `regulatoryCostsTotalAmountMicros` string, int64: Output only. The total amount of invoice level regulatory costs, in micros. - `replacedInvoices` string[]: Output only. The resource name of the original invoice(s) being rebilled or replaced by this invoice, if applicable. There might be multiple replaced invoices due to invoice consolidation. The replaced invoices may not belong to the same payments account. If `replaced_invoices` is set, `corrected_invoice` will not be set. Invoice resource names have the form: `customers/{customer_id}/invoices/{invoice_id}` - `resourceName` string: Output only. The resource name of the invoice. Multiple customers can share a given invoice, so multiple resource names may point to the same invoice. Invoice resource names have the form: `customers/{customer_id}/invoices/{invoice_id}` - `serviceDateRange` GoogleAdsSearchads360V23CommonDateRange: A date range. - `endDate` string: The end date, in yyyy-mm-dd format. This date is inclusive. - `startDate` string: The start date, in yyyy-mm-dd format. This date is inclusive. - `subtotalAmountMicros` string, int64: Output only. The pretax subtotal amount, in micros. This is equal to the sum of the AccountBudgetSummary subtotal amounts and Invoice.adjustments_subtotal_amount_micros. - `taxAmountMicros` string, int64: Output only. The sum of all taxes on the invoice, in micros. This equals the sum of the AccountBudgetSummary tax amounts, plus taxes not associated with a specific account budget. - `totalAmountMicros` string, int64: Output only. The total amount, in micros. This equals the sum of Invoice.subtotal_amount_micros, Invoice.tax_amount_micros, Invoice.regulatory_costs_subtotal_amount_micros, and Invoice.export_charge_subtotal_amount_micros (which is separated into a separate line item starting with V14.1). - `type` 'UNSPECIFIED' | 'UNKNOWN' | 'CREDIT_MEMO' | 'INVOICE': Output only. The type of invoice. --- [API](https://skmtc.dev/google/apis/searchads360.md) - [All operations](https://skmtc.dev/google/apis/searchads360/llms.txt) - [OpenAPI document](https://skmtc.dev/google/apis/searchads360/revisions/4a4511f84b18?raw)