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

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

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

## Request

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

Gets an invoice by ID. 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
- `invoiceName` string, required

## Query parameters

- `api-version` string, required

## Response `200`

OK. The request has succeeded.

- Invoice: An invoice.
  - `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.

## 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)
