Invoices - List By Billing Subscription

Reference

Service:: Billing

API Version:: 2020-05-01

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

/** Samples for Invoices ListByBillingSubscription. */
public final class Main {
    /*
     * x-ms-original-file: specification/billing/resource-manager/Microsoft.Billing/stable/2020-05-01/examples/BillingSubscriptionInvoicesList.json
     */
    /**
     * Sample code: BillingSubscriptionsListByBillingAccount.
     *
     * @param manager Entry point to BillingManager.
     */
    public static void billingSubscriptionsListByBillingAccount(
        com.azure.resourcemanager.billing.BillingManager manager) {
        manager.invoices().listByBillingSubscription("2022-01-01", "2022-06-30", com.azure.core.util.Context.NONE);
    }
}

To use the Azure SDK library in your project, see this documentation. To provide feedback on this code sample, open a GitHub issue

package armbilling_test

import (
	"context"
	"log"

	"github.com/Azure/azure-sdk-for-go/sdk/azidentity"
	"github.com/Azure/azure-sdk-for-go/sdk/resourcemanager/billing/armbilling"
)

// Generated from example definition: https://github.com/Azure/azure-rest-api-specs/blob/7a2ac91de424f271cf91cc8009f3fe9ee8249086/specification/billing/resource-manager/Microsoft.Billing/stable/2020-05-01/examples/BillingSubscriptionInvoicesList.json
func ExampleInvoicesClient_NewListByBillingSubscriptionPager() {
	cred, err := azidentity.NewDefaultAzureCredential(nil)
	if err != nil {
		log.Fatalf("failed to obtain a credential: %v", err)
	}
	ctx := context.Background()
	clientFactory, err := armbilling.NewClientFactory("<subscription-id>", cred, nil)
	if err != nil {
		log.Fatalf("failed to create client: %v", err)
	}
	pager := clientFactory.NewInvoicesClient().NewListByBillingSubscriptionPager("2018-01-01", "2018-06-30", nil)
	for pager.More() {
		page, err := pager.NextPage(ctx)
		if err != nil {
			log.Fatalf("failed to advance page: %v", err)
		}
		for _, v := range page.Value {
			// You could use page here. We use blank identifier for just demo purposes.
			_ = v
		}
		// If the HTTP response code is 200 as defined in example definition, your page structure would look as follows. Please pay attention that all the values in the output are fake values for just demo purposes.
		// page.InvoiceListResult = armbilling.InvoiceListResult{
		// 	Value: []*armbilling.Invoice{
		// 		{
		// 			Name: to.Ptr("1383723"),
		// 			Type: to.Ptr("Microsoft.Billing/billingAccounts/billingSubscriptions/invoices"),
		// 			ID: to.Ptr("providers/Microsoft.Billing/billingAccounts/{billingAccountName}/billingSubscriptions/11000000-0000-0000-0000-000000000000/invoices/1383723"),
		// 			Properties: &armbilling.InvoiceProperties{
		// 				AmountDue: &armbilling.Amount{
		// 					Currency: to.Ptr("USD"),
		// 					Value: to.Ptr[float32](2000),
		// 				},
		// 				DueDate: to.Ptr(func() time.Time { t, _ := time.Parse(time.RFC3339Nano, "2018-01-16T17:32:28.000Z"); return t}()),
		// 				InvoiceDate: to.Ptr(func() time.Time { t, _ := time.Parse(time.RFC3339Nano, "2018-01-01T17:32:28.000Z"); return t}()),
		// 				InvoicePeriodEndDate: to.Ptr(func() time.Time { t, _ := time.Parse(time.RFC3339Nano, "2018-01-15T17:32:28.000Z"); return t}()),
		// 				InvoicePeriodStartDate: to.Ptr(func() time.Time { t, _ := time.Parse(time.RFC3339Nano, "2018-01-01T17:32:28.000Z"); return t}()),
		// 				InvoiceType: to.Ptr(armbilling.InvoiceType("AzureServices")),
		// 				PurchaseOrderNumber: to.Ptr("123456"),
		// 				Status: to.Ptr(armbilling.InvoiceStatusDue),
		// 				SubscriptionID: to.Ptr("55000000-0000-0000-0000-000000000011"),
		// 			},
		// 		},
		// 		{
		// 			Name: to.Ptr("1383724"),
		// 			Type: to.Ptr("Microsoft.Billing/billingAccounts/billingSubscriptions/invoices"),
		// 			ID: to.Ptr("providers/Microsoft.Billing/billingAccounts/{billingAccountName}/billingSubscriptions/11000000-0000-0000-0000-000000000000/invoices/1383724"),
		// 			Properties: &armbilling.InvoiceProperties{
		// 				AmountDue: &armbilling.Amount{
		// 					Currency: to.Ptr("USD"),
		// 					Value: to.Ptr[float32](2000),
		// 				},
		// 				BilledAmount: &armbilling.Amount{
		// 					Currency: to.Ptr("USD"),
		// 					Value: to.Ptr[float32](2000),
		// 				},
		// 				BillingProfileDisplayName: to.Ptr("Contoso Operations Billing"),
		// 				BillingProfileID: to.Ptr("/providers/Microsoft.Billing/billingAccounts/{billingAccountName}/billingProfiles/11000000-0000-0000-0000-000000000000"),
		// 				Documents: []*armbilling.Document{
		// 					{
		// 						Kind: to.Ptr(armbilling.DocumentTypeInvoice),
		// 						Source: to.Ptr(armbilling.DocumentSourceDRS),
		// 						URL: to.Ptr("https://management.azure.com/providers/Microsoft.Billing/billingAccounts/{billingAccountName}/billingSubscriptions/11000000-0000-0000-0000-000000000000/invoices/1383724/download"),
		// 				}},
		// 				DueDate: to.Ptr(func() time.Time { t, _ := time.Parse(time.RFC3339Nano, "2018-03-01T17:32:28.000Z"); return t}()),
		// 				InvoiceDate: to.Ptr(func() time.Time { t, _ := time.Parse(time.RFC3339Nano, "2018-02-01T17:32:28.000Z"); return t}()),
		// 				InvoicePeriodEndDate: to.Ptr(func() time.Time { t, _ := time.Parse(time.RFC3339Nano, "2018-03-02T17:32:28.000Z"); return t}()),
		// 				InvoicePeriodStartDate: to.Ptr(func() time.Time { t, _ := time.Parse(time.RFC3339Nano, "2018-02-01T17:32:28.000Z"); return t}()),
		// 				InvoiceType: to.Ptr(armbilling.InvoiceTypeAzureMarketplace),
		// 				Payments: []*armbilling.PaymentProperties{
		// 					{
		// 						Amount: &armbilling.Amount{
		// 							Currency: to.Ptr("USD"),
		// 							Value: to.Ptr[float32](2000),
		// 						},
		// 						Date: to.Ptr(func() time.Time { t, _ := time.Parse(time.RFC3339Nano, "2018-01-14T17:32:28.000Z"); return t}()),
		// 						PaymentMethodFamily: to.Ptr(armbilling.PaymentMethodFamilyCreditCard),
		// 						PaymentMethodType: to.Ptr("visa"),
		// 						PaymentType: to.Ptr("credited"),
		// 				}},
		// 				PurchaseOrderNumber: to.Ptr("123456"),
		// 				Status: to.Ptr(armbilling.InvoiceStatusPaid),
		// 				SubscriptionID: to.Ptr("55000000-0000-0000-0000-000000000011"),
		// 			},
		// 	}},
		// }
	}
}

To use the Azure SDK library in your project, see this documentation. To provide feedback on this code sample, open a GitHub issue

const { BillingManagementClient } = require("@azure/arm-billing");
const { DefaultAzureCredential } = require("@azure/identity");

/**
 * This sample demonstrates how to Lists the invoices for a subscription.
 *
 * @summary Lists the invoices for a subscription.
 * x-ms-original-file: specification/billing/resource-manager/Microsoft.Billing/stable/2020-05-01/examples/BillingSubscriptionInvoicesList.json
 */
async function billingSubscriptionsListByBillingAccount() {
  const subscriptionId = "{subscriptionId}";
  const periodStartDate = "2018-01-01";
  const periodEndDate = "2018-06-30";
  const credential = new DefaultAzureCredential();
  const client = new BillingManagementClient(credential, subscriptionId);
  const resArray = new Array();
  for await (let item of client.invoices.listByBillingSubscription(
    periodStartDate,
    periodEndDate
  )) {
    resArray.push(item);
  }
  console.log(resArray);
}

billingSubscriptionsListByBillingAccount().catch(console.error);

To use the Azure SDK library in your project, see this documentation. To provide feedback on this code sample, open a GitHub issue

Sample response

Status code:: 200

{
  "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.

Udostępnij za pośrednictwem

Invoices - List By Billing Subscription

URI Parameters

Responses

Security

azure_auth

Scopes

Examples

BillingSubscriptionsListByBillingAccount

Sample request

Sample response

Definitions

Amount

Document

DocumentSource

DocumentType

ErrorDetails

ErrorResponse

ErrorSubDetails

Invoice

InvoiceDocumentType

InvoiceListResult

InvoiceStatus

InvoiceType

PaymentMethodFamily

PaymentProperties

RebillDetails

Dodatkowe zasoby