Invoices - List By Billing Subscription

Lists the invoices for a subscription.

GET https://management.azure.com/providers/Microsoft.Billing/billingAccounts/default/billingSubscriptions/{subscriptionId}/invoices?periodStartDate={periodStartDate}&periodEndDate={periodEndDate}&api-version=2020-05-01

URI Parameters

Name In Required Type Description
subscriptionId
path True

string

The ID that uniquely identifies an Azure subscription.

api-version
query True

string

The version of the API to be used with the client request. The current version is 2020-05-01.

periodEndDate
query True

string

Invoice period end date.

periodStartDate
query True

string

Invoice period start date.

Responses

Name Type Description
200 OK

InvoiceListResult

OK. The request has succeeded.

Other Status Codes

ErrorResponse

Error response describing why the operation failed.

Security

azure_auth

Azure Active Directory OAuth2 Flow.

Type: oauth2
Flow: implicit
Authorization URL: https://login.microsoftonline.com/common/oauth2/authorize

Scopes

Name Description
user_impersonation impersonate your user account

Examples

BillingSubscriptionsListByBillingAccount

Sample request

GET https://management.azure.com/providers/Microsoft.Billing/billingAccounts/default/billingSubscriptions/{subscriptionId}/invoices?periodStartDate=2022-01-01&periodEndDate=2022-06-30&api-version=2020-05-01

Sample response

{
  "value": [
    {
      "id": "providers/Microsoft.Billing/billingAccounts/{billingAccountName}/billingSubscriptions/11000000-0000-0000-0000-000000000000/invoices/1383723",
      "name": "1383723",
      "type": "Microsoft.Billing/billingAccounts/billingSubscriptions/invoices",
      "properties": {
        "dueDate": "2022-01-16T17:32:28Z",
        "invoiceDate": "2022-01-01T17:32:28Z",
        "status": "Due",
        "amountDue": {
          "currency": "USD",
          "value": 2000
        },
        "invoicePeriodStartDate": "2022-01-01T17:32:28Z",
        "invoicePeriodEndDate": "2022-01-15T17:32:28Z",
        "invoiceType": "AzureServices",
        "purchaseOrderNumber": "123456",
        "subscriptionId": "55000000-0000-0000-0000-000000000011"
      }
    },
    {
      "id": "providers/Microsoft.Billing/billingAccounts/{billingAccountName}/billingSubscriptions/11000000-0000-0000-0000-000000000000/invoices/1383724",
      "name": "1383724",
      "type": "Microsoft.Billing/billingAccounts/billingSubscriptions/invoices",
      "properties": {
        "dueDate": "2022-02-01T17:32:28Z",
        "invoiceDate": "2022-01-01T17:32:28Z",
        "status": "Paid",
        "amountDue": {
          "currency": "USD",
          "value": 2000
        },
        "billedAmount": {
          "currency": "USD",
          "value": 2000
        },
        "invoicePeriodStartDate": "2022-01-01T17:32:28Z",
        "invoicePeriodEndDate": "2022-01-30T17:32:28Z",
        "invoiceType": "AzureMarketplace",
        "billingProfileId": "/providers/Microsoft.Billing/billingAccounts/{billingAccountName}/billingProfiles/11000000-0000-0000-0000-000000000000",
        "billingProfileDisplayName": "Contoso Operations Billing",
        "purchaseOrderNumber": "123456",
        "documents": [
          {
            "kind": "Invoice",
            "url": "https://management.azure.com/providers/Microsoft.Billing/billingAccounts/{billingAccountName}/billingSubscriptions/11000000-0000-0000-0000-000000000000/invoices/1383724/download",
            "source": "DRS"
          }
        ],
        "payments": [
          {
            "date": "2022-01-14T17:32:28Z",
            "paymentType": "credited",
            "amount": {
              "currency": "USD",
              "value": 2000
            },
            "paymentMethodFamily": "CreditCard",
            "paymentMethodType": "visa"
          }
        ],
        "subscriptionId": "55000000-0000-0000-0000-000000000011"
      }
    }
  ]
}

Definitions

Name Description
Amount

The amount.

Document

The properties of a document.

DocumentSource

The source of the document. ENF for Brazil and DRS for rest of the world.

DocumentType

The type of the document.

ErrorDetails

The details of the error.

ErrorResponse

Error response indicates that the service is not able to process the incoming request. The reason is provided in the error message.

ErrorSubDetails
Invoice

An invoice.

InvoiceDocumentType

The type of the document.

InvoiceListResult

The list of invoices.

InvoiceStatus

The current status of the invoice.

InvoiceType

Invoice type.

PaymentMethodFamily

The family of payment method.

PaymentProperties

The properties of a payment.

RebillDetails

The rebill details of an invoice.

Amount

The amount.

Name Type Description
currency

string

The currency for the amount value.

value

number

Amount value.

Document

The properties of a document.

Name Type Description
kind

DocumentType

The type of the document.

source

DocumentSource

The source of the document. ENF for Brazil and DRS for rest of the world.

url

string

Document URL.

DocumentSource

The source of the document. ENF for Brazil and DRS for rest of the world.

Name Type Description
DRS

string

ENF

string

DocumentType

The type of the document.

Name Type Description
CreditNote

string

Invoice

string

TaxReceipt

string

VoidNote

string

ErrorDetails

The details of the error.

Name Type Description
code

string

Error code.

details

ErrorSubDetails[]

The sub details of the error.

message

string

Error message indicating why the operation failed.

target

string

The target of the particular error.

ErrorResponse

Error response indicates that the service is not able to process the incoming request. The reason is provided in the error message.

Name Type Description
error

ErrorDetails

The details of the error.

ErrorSubDetails

Name Type Description
code

string

Error code.

message

string

Error message indicating why the operation failed.

target

string

The target of the particular error.

Invoice

An invoice.

Name Type Description
id

string

Resource Id.

name

string

Resource name.

properties.amountDue

Amount

The amount due as of now.

properties.azurePrepaymentApplied

Amount

The amount of Azure prepayment applied to the charges. This field is applicable to billing accounts with agreement type Microsoft Customer Agreement.

properties.billedAmount

Amount

The total charges for the invoice billing period.

properties.billedDocumentId

string

The Id of the active invoice which is originally billed after this invoice was voided. This field is applicable to the void invoices only.

properties.billingProfileDisplayName

string

The name of the billing profile for which the invoice is generated.

properties.billingProfileId

string

The ID of the billing profile for which the invoice is generated.

properties.creditAmount

Amount

The total refund for returns and cancellations during the invoice billing period. This field is applicable to billing accounts with agreement type Microsoft Customer Agreement.

properties.creditForDocumentId

string

The Id of the invoice which got voided and this credit note was issued as a result. This field is applicable to the credit notes only.

properties.documentType

InvoiceDocumentType

The type of the document.

properties.documents

Document[]

List of documents available to download such as invoice and tax receipt.

properties.dueDate

string

The due date for the invoice.

properties.freeAzureCreditApplied

Amount

The amount of free Azure credits applied to the charges. This field is applicable to billing accounts with agreement type Microsoft Customer Agreement.

properties.invoiceDate

string

The date when the invoice was generated.

properties.invoicePeriodEndDate

string

The end date of the billing period for which the invoice is generated.

properties.invoicePeriodStartDate

string

The start date of the billing period for which the invoice is generated.

properties.invoiceType

InvoiceType

Invoice type.

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

properties.payments

PaymentProperties[]

List of payments.

properties.purchaseOrderNumber

string

An optional purchase order number for the invoice.

properties.rebillDetails

<string,  RebillDetails>

Rebill details for an invoice.

properties.status

InvoiceStatus

The current status of the invoice.

properties.subTotal

Amount

The pre-tax amount due. This field is applicable to billing accounts with agreement type Microsoft Customer Agreement.

properties.subscriptionId

string

The ID of the subscription for which the invoice is generated.

properties.taxAmount

Amount

The amount of tax charged for the billing period. This field is applicable to billing accounts with agreement type Microsoft Customer Agreement.

properties.totalAmount

Amount

The amount due when the invoice was generated. This field is applicable to billing accounts with agreement type Microsoft Customer Agreement.

type

string

Resource type.

InvoiceDocumentType

The type of the document.

Name Type Description
CreditNote

string

Invoice

string

InvoiceListResult

The list of invoices.

Name Type Description
nextLink

string

The link (url) to the next page of results.

totalCount

number

Total number of records.

value

Invoice[]

The list of invoices.

InvoiceStatus

The current status of the invoice.

Name Type Description
Due

string

OverDue

string

Paid

string

Void

string

InvoiceType

Invoice type.

Name Type Description
AzureMarketplace

string

AzureService

string

AzureSupport

string

PaymentMethodFamily

The family of payment method.

Name Type Description
CheckWire

string

CreditCard

string

Credits

string

None

string

PaymentProperties

The properties of a payment.

Name Type Description
amount

Amount

The paid amount.

date

string

The date when the payment was made.

paymentMethodFamily

PaymentMethodFamily

The family of payment method.

paymentMethodType

string

The type of payment method.

paymentType

string

The type of payment.

RebillDetails

The rebill details of an invoice.

Name Type Description
creditNoteDocumentId

string

The ID of credit note.

invoiceDocumentId

string

The ID of invoice.

rebillDetails

<string,  RebillDetails>

Rebill details for an invoice.