---
title: "GET /providers/Microsoft.Billing/billingAccounts/{billingAccountName}/billingProfiles/{billingProfileName}/invoices"
method: GET
path: "/providers/Microsoft.Billing/billingAccounts/{billingAccountName}/billingProfiles/{billingProfileName}/invoices"
tags: ["Invoices"]
---

# GET /providers/Microsoft.Billing/billingAccounts/{billingAccountName}/billingProfiles/{billingProfileName}/invoices

`GET /providers/Microsoft.Billing/billingAccounts/{billingAccountName}/billingProfiles/{billingProfileName}/invoices`

## Request

- Base URL: `https://management.azure.com`
- URL: `https://management.azure.com/providers/Microsoft.Billing/billingAccounts/{billingAccountName}/billingProfiles/{billingProfileName}/invoices`
- Auth: OAuth 2
  - Implicit: `https://login.microsoftonline.com/common/oauth2/authorize`
  - Scopes: `user_impersonation`

Lists the invoices for a billing profile for a given start date and end date. The operation is supported for billing accounts with agreement type Microsoft Partner Agreement or Microsoft Customer Agreement.

## Path parameters

- `billingAccountName` string, required
- `billingProfileName` string, required

## Query parameters

- `api-version` string, required
- `periodStartDate` string, required
- `periodEndDate` string, required

## Response `200`

OK. The request has succeeded.

- InvoiceListResult: The list of invoices.
  - `value` Invoice[]: The list of invoices.
    - `id` string: Resource Id.
    - `name` string: Resource name.
    - `type` string: Resource type.
    - `properties` InvoiceProperties: The properties of the invoice.
      - `dueDate` string, date-time: The due date for the invoice.
      - `invoiceDate` string, date-time: The date when the invoice was generated.
      - `status` 'Due' | 'OverDue' | 'Paid' | 'Void': The current status of the invoice.
      - `amountDue` Amount: The amount.
        - `currency` string: The currency for the amount value.
        - `value` number: Amount value.
      - `azurePrepaymentApplied` Amount: The amount.
        - `currency` string: The currency for the amount value.
        - `value` number: Amount value.
      - `billedAmount` Amount: The amount.
        - `currency` string: The currency for the amount value.
        - `value` number: Amount value.
      - `creditAmount` Amount: The amount.
        - `currency` string: The currency for the amount value.
        - `value` number: Amount value.
      - `freeAzureCreditApplied` Amount: The amount.
        - `currency` string: The currency for the amount value.
        - `value` number: Amount value.
      - `subTotal` Amount: The amount.
        - `currency` string: The currency for the amount value.
        - `value` number: Amount value.
      - `taxAmount` Amount: The amount.
        - `currency` string: The currency for the amount value.
        - `value` number: Amount value.
      - `totalAmount` Amount: The amount.
        - `currency` string: The currency for the amount value.
        - `value` number: Amount value.
      - `invoicePeriodStartDate` string, date-time: The start date of the billing period for which the invoice is generated.
      - `invoicePeriodEndDate` string, date-time: The end date of the billing period for which the invoice is generated.
      - `invoiceType` 'AzureService' | 'AzureMarketplace' | 'AzureSupport': Invoice type.
      - `isMonthlyInvoice` boolean: Specifies if the invoice is generated as part of monthly invoicing cycle or not. This field is applicable to billing accounts with agreement type Microsoft Customer Agreement.
      - `billingProfileId` string: The ID of the billing profile for which the invoice is generated.
      - `billingProfileDisplayName` string: The name of the billing profile for which the invoice is generated.
      - `purchaseOrderNumber` string: An optional purchase order number for the invoice.
      - `documents` Document[]: List of documents available to download such as invoice and tax receipt.
        - `kind` 'Invoice' | 'VoidNote' | 'TaxReceipt' | 'CreditNote': The type of the document.
        - `url` string: Document URL.
        - `documentNumbers` string[]: Document numbers for an Enterprise Agreement invoice.
      - `payments` PaymentProperties[]: List of payments.
        - `paymentType` string: The type of payment.
        - `amount` Amount: The amount.
          - `currency` string: The currency for the amount value.
          - `value` number: Amount value.
        - `date` string, date-time: The date when the payment was made.
        - `paymentMethodFamily` 'Credits' | 'CheckWire' | 'CreditCard' | 'None': The family of payment method.
        - `paymentMethodType` string: The type of payment method.
      - `subscriptionId` string: The ID of the subscription for which the invoice is generated.
      - `rebillDetails` InvoiceRebillDetails: The rebill details of an invoice.
        - `rebillDocumentType` 'Credit' | 'Rebill' | 'Original': The type of the document generated when an Enterprise Agreement invoice is rebilled.
        - `rebilledInvoiceId` string: The ID of the invoice generated when an Enterprise Agreement invoice is rebilled.
        - `latestInvoiceId` string: The ID of the latest invoice generated when an Enterprise Agreement invoice is rebilled.
  - `nextLink` string: The link (url) to the next page of results.
  - `totalCount` number: Total number of records.

## Other responses

- `default`: Error response describing why the operation failed.

---

[API](https://skmtc.dev/azure/apis/billingmanagementclient.md) - [All operations](https://skmtc.dev/azure/apis/billingmanagementclient/llms.txt) - [OpenAPI document](https://skmtc.dev/azure/apis/billingmanagementclient/revisions/481e7355ac16?raw)
