Microsoft Azure

Azure Billing

Billing client provides access to billing resources for Azure subscriptions.

Finance & banking#openapi

Fork copies the collection into your workspace, without the publisher's secrets, so you can add your own key and send requests. Star saves it to your starred APIs (Account › Marketplace) and helps others find it.

Overview

Billing client provides access to billing resources for Azure subscriptions.

Endpoints 74

BillingAccounts

  • GETBillingAccounts_List/providers/Microsoft.Billing/billingAccounts?api-version=string&$expand=stringLists the billing accounts that a user has access to.
  • GETBillingAccounts_Get/providers/Microsoft.Billing/billingAccounts/:billingAccountName?api-version=string&$expand=stringGets a billing account by its ID.
  • PATCHBillingAccounts_Update/providers/Microsoft.Billing/billingAccounts/:billingAccountName?api-version=stringUpdates the properties of a billing account. Currently, displayName and address can be updated. The operation is supported only for billing accounts with…
  • POSTBillingAccounts_ListInvoiceSectionsByCreateSubscriptionPermission/providers/Microsoft.Billing/billingAccounts/:billingAccountName/listInvoiceSectionsWithCreateSubscriptionPermission?api-version=stringLists the invoice sections for which the user has permission to create Azure subscriptions. The operation is supported only for billing accounts with…

Address

  • POSTAddress_Validate/providers/Microsoft.Billing/validateAddress?api-version=stringValidates an address. Use the operation to validate an address before using it as soldTo or a billTo address.

AvailableBalances

  • GETAvailableBalances_Get/providers/Microsoft.Billing/billingAccounts/:billingAccountName/billingProfiles/:billingProfileName/availableBalance/default?api-version=stringThe available credit balance for a billing profile. This is the balance that can be used for pay now to settle due or past due invoices. The operation is…

Instructions

  • GETInstructions_ListByBillingProfile/providers/Microsoft.Billing/billingAccounts/:billingAccountName/billingProfiles/:billingProfileName/instructions?api-version=stringLists the instructions by billing profile id.
  • GETInstructions_Get/providers/Microsoft.Billing/billingAccounts/:billingAccountName/billingProfiles/:billingProfileName/instructions/:instructionName?api-version=stringGet the instruction by name. These are custom billing instructions and are only applicable for certain customers.
  • PUTInstructions_Put/providers/Microsoft.Billing/billingAccounts/:billingAccountName/billingProfiles/:billingProfileName/instructions/:instructionName?api-version=stringCreates or updates an instruction. These are custom billing instructions and are only applicable for certain customers.

BillingProfiles

  • GETBillingProfiles_ListByBillingAccount/providers/Microsoft.Billing/billingAccounts/:billingAccountName/billingProfiles?api-version=string&$expand=stringLists the billing profiles that a user has access to. The operation is supported for billing accounts with agreement type Microsoft Customer Agreement or…
  • GETBillingProfiles_Get/providers/Microsoft.Billing/billingAccounts/:billingAccountName/billingProfiles/:billingProfileName?api-version=string&$expand=stringGets a billing profile by its ID. The operation is supported for billing accounts with agreement type Microsoft Customer Agreement or Microsoft Partner…
  • PUTBillingProfiles_CreateOrUpdate/providers/Microsoft.Billing/billingAccounts/:billingAccountName/billingProfiles/:billingProfileName?api-version=stringCreates or updates a billing profile. The operation is supported for billing accounts with agreement type Microsoft Customer Agreement or Microsoft Partner…

Customers

  • GETCustomers_ListByBillingProfile/providers/Microsoft.Billing/billingAccounts/:billingAccountName/billingProfiles/:billingProfileName/customers?api-version=string&$search=string&$filter=stringLists the customers that are billed to a billing profile. The operation is supported only for billing accounts with agreement type Microsoft Partner Agreement.
  • GETCustomers_ListByBillingAccount/providers/Microsoft.Billing/billingAccounts/:billingAccountName/customers?api-version=string&$search=string&$filter=stringLists the customers that are billed to a billing account. The operation is supported only for billing accounts with agreement type Microsoft Partner Agreement.
  • GETCustomers_Get/providers/Microsoft.Billing/billingAccounts/:billingAccountName/customers/:customerName?api-version=string&$expand=stringGets a customer by its ID. The operation is supported only for billing accounts with agreement type Microsoft Partner Agreement.

InvoiceSections

  • GETInvoiceSections_ListByBillingProfile/providers/Microsoft.Billing/billingAccounts/:billingAccountName/billingProfiles/:billingProfileName/invoiceSections?api-version=stringLists the invoice sections that a user has access to. The operation is supported only for billing accounts with agreement type Microsoft Customer Agreement.
  • GETInvoiceSections_Get/providers/Microsoft.Billing/billingAccounts/:billingAccountName/billingProfiles/:billingProfileName/invoiceSections/:invoiceSectionName?api-version=stringGets an invoice section by its ID. The operation is supported only for billing accounts with agreement type Microsoft Customer Agreement.
  • PUTInvoiceSections_CreateOrUpdate/providers/Microsoft.Billing/billingAccounts/:billingAccountName/billingProfiles/:billingProfileName/invoiceSections/:invoiceSectionName?api-version=stringCreates or updates an invoice section. The operation is supported only for billing accounts with agreement type Microsoft Customer Agreement.

BillingPermissions

  • GETBillingPermissions_ListByCustomer/providers/Microsoft.Billing/billingAccounts/:billingAccountName/customers/:customerName/billingPermissions?api-version=stringLists the billing permissions the caller has for a customer.
  • GETBillingPermissions_ListByBillingAccount/providers/Microsoft.Billing/billingAccounts/:billingAccountName/billingPermissions?api-version=stringLists the billing permissions the caller has on a billing account.
  • GETBillingPermissions_ListByInvoiceSections/providers/Microsoft.Billing/billingAccounts/:billingAccountName/billingProfiles/:billingProfileName/invoiceSections/:invoiceSectionName/billingPermissions?api-version=stringLists the billing permissions the caller has on an invoice section.
  • GETBillingPermissions_ListByBillingProfile/providers/Microsoft.Billing/billingAccounts/:billingAccountName/billingProfiles/:billingProfileName/billingPermissions?api-version=stringLists the billing permissions the caller has on a billing profile.

BillingSubscriptions

  • GETBillingSubscriptions_ListByCustomer/providers/Microsoft.Billing/billingAccounts/:billingAccountName/customers/:customerName/billingSubscriptions?api-version=stringLists the subscriptions for a customer. The operation is supported only for billing accounts with agreement type Microsoft Partner Agreement.
  • GETBillingSubscriptions_ListByBillingAccount/providers/Microsoft.Billing/billingAccounts/:billingAccountName/billingSubscriptions?api-version=stringLists the subscriptions for a billing account. The operation is supported for billing accounts with agreement type Microsoft Customer Agreement or Microsoft…
  • GETBillingSubscriptions_ListByBillingProfile/providers/Microsoft.Billing/billingAccounts/:billingAccountName/billingProfiles/:billingProfileName/billingSubscriptions?api-version=stringLists the subscriptions that are billed to a billing profile. The operation is supported for billing accounts with agreement type Microsoft Customer Agreement…
  • GETBillingSubscriptions_ListByInvoiceSection/providers/Microsoft.Billing/billingAccounts/:billingAccountName/billingProfiles/:billingProfileName/invoiceSections/:invoiceSectionName/billingSubscriptions?api-version=stringLists the subscriptions that are billed to an invoice section. The operation is supported only for billing accounts with agreement type Microsoft Customer…
  • GETBillingSubscriptions_Get/providers/Microsoft.Billing/billingAccounts/:billingAccountName/billingSubscriptions/:subscriptionId?api-version=stringGets a subscription by its ID. The operation is supported for billing accounts with agreement type Microsoft Customer Agreement and Microsoft Partner Agreement.
  • PATCHBillingSubscriptions_Update/providers/Microsoft.Billing/billingAccounts/:billingAccountName/billingSubscriptions/:subscriptionId?api-version=stringUpdates the properties of a billing subscription. Currently, cost center can be updated. The operation is supported only for billing accounts with agreement…

Products

  • GETProducts_ListByCustomer/providers/Microsoft.Billing/billingAccounts/:billingAccountName/customers/:customerName/products?api-version=stringLists the products for a customer. These don't include products billed based on usage.The operation is supported only for billing accounts with agreement type…
  • GETProducts_ListByBillingAccount/providers/Microsoft.Billing/billingAccounts/:billingAccountName/products?api-version=string&$filter=stringLists the products for a billing account. These don't include products billed based on usage. The operation is supported for billing accounts with agreement…
  • GETProducts_ListByBillingProfile/providers/Microsoft.Billing/billingAccounts/:billingAccountName/billingProfiles/:billingProfileName/products?api-version=string&$filter=stringLists the products for a billing profile. These don't include products billed based on usage. The operation is supported for billing accounts with agreement…
  • GETProducts_ListByInvoiceSection/providers/Microsoft.Billing/billingAccounts/:billingAccountName/billingProfiles/:billingProfileName/invoiceSections/:invoiceSectionName/products?api-version=string&$filter=stringLists the products for an invoice section. These don't include products billed based on usage. The operation is supported only for billing accounts with…
  • GETProducts_Get/providers/Microsoft.Billing/billingAccounts/:billingAccountName/products/:productName?api-version=stringGets a product by ID. The operation is supported only for billing accounts with agreement type Microsoft Customer Agreement.
  • PATCHProducts_Update/providers/Microsoft.Billing/billingAccounts/:billingAccountName/products/:productName?api-version=stringUpdates the properties of a Product. Currently, auto renew can be updated. The operation is supported only for billing accounts with agreement type Microsoft…
  • POSTProducts_Move/providers/Microsoft.Billing/billingAccounts/:billingAccountName/products/:productName/move?api-version=stringMoves a product's charges to a new invoice section. The new invoice section must belong to the same billing profile as the existing invoice section. This…

Invoices

  • GETInvoices_ListByBillingAccount/providers/Microsoft.Billing/billingAccounts/:billingAccountName/invoices?api-version=string&periodStartDate=string&periodEndDate=stringLists the invoices for a billing account for a given start date and end date. The operation is supported for billing accounts with agreement type Microsoft…
  • GETInvoices_ListByBillingProfile/providers/Microsoft.Billing/billingAccounts/:billingAccountName/billingProfiles/:billingProfileName/invoices?api-version=string&periodStartDate=string&periodEndDate=stringLists 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…
  • GETInvoices_Get/providers/Microsoft.Billing/billingAccounts/:billingAccountName/invoices/:invoiceName?api-version=stringGets an invoice by billing account name and ID. The operation is supported for billing accounts with agreement type Microsoft Partner Agreement or Microsoft…
  • GETInvoices_GetById/providers/Microsoft.Billing/billingAccounts/default/invoices/:invoiceName?api-version=stringGets an invoice by ID. The operation is supported for billing accounts with agreement type Microsoft Partner Agreement or Microsoft Customer Agreement.
  • POSTInvoices_DownloadInvoice/providers/Microsoft.Billing/billingAccounts/:billingAccountName/invoices/:invoiceName/download?api-version=string&downloadToken=stringGets a URL to download an invoice. The operation is supported for billing accounts with agreement type Microsoft Partner Agreement or Microsoft Customer…
  • POSTInvoices_DownloadMultipleBillingProfileInvoices/providers/Microsoft.Billing/billingAccounts/:billingAccountName/downloadDocuments?api-version=stringGets a URL to download multiple invoice documents (invoice pdf, tax receipts, credit notes) as a zip file. The operation is supported for billing accounts…
  • GETInvoices_ListByBillingSubscription/providers/Microsoft.Billing/billingAccounts/default/billingSubscriptions/:subscriptionId/invoices?periodStartDate=string&periodEndDate=string&api-version=stringLists the invoices for a subscription.
  • GETInvoices_GetBySubscriptionAndInvoiceId/providers/Microsoft.Billing/billingAccounts/default/billingSubscriptions/:subscriptionId/invoices/:invoiceName?api-version=stringGets an invoice by subscription ID and invoice ID.
  • POSTInvoices_DownloadBillingSubscriptionInvoice/providers/Microsoft.Billing/billingAccounts/default/billingSubscriptions/:subscriptionId/invoices/:invoiceName/download?api-version=string&downloadToken=stringGets a URL to download an invoice.
  • POSTInvoices_DownloadMultipleBillingSubscriptionInvoices/providers/Microsoft.Billing/billingAccounts/default/billingSubscriptions/:subscriptionId/downloadDocuments?api-version=stringGets a URL to download multiple invoice documents (invoice pdf, tax receipts, credit notes) as a zip file.

Transactions

  • GETTransactions_ListByInvoice/providers/Microsoft.Billing/billingAccounts/:billingAccountName/invoices/:invoiceName/transactions?api-version=stringLists the transactions for an invoice. Transactions include purchases, refunds and Azure usage charges.

Policies

  • GETPolicies_GetByBillingProfile/providers/Microsoft.Billing/billingAccounts/:billingAccountName/billingProfiles/:billingProfileName/policies/default?api-version=stringLists the policies for a billing profile. This operation is supported only for billing accounts with agreement type Microsoft Customer Agreement.
  • PUTPolicies_Update/providers/Microsoft.Billing/billingAccounts/:billingAccountName/billingProfiles/:billingProfileName/policies/default?api-version=stringUpdates the policies for a billing profile. This operation is supported only for billing accounts with agreement type Microsoft Customer Agreement.
  • GETPolicies_GetByCustomer/providers/Microsoft.Billing/billingAccounts/:billingAccountName/customers/:customerName/policies/default?api-version=stringLists the policies for a customer. This operation is supported only for billing accounts with agreement type Microsoft Partner Agreement.
  • PUTPolicies_UpdateCustomer/providers/Microsoft.Billing/billingAccounts/:billingAccountName/customers/:customerName/policies/default?api-version=stringUpdates the policies for a customer. This operation is supported only for billing accounts with agreement type Microsoft Partner Agreement.

BillingProperties

  • GETBillingProperty_Get/subscriptions/:subscriptionId/providers/Microsoft.Billing/billingProperty/default?api-version=stringGet the billing properties for a subscription. This operation is not supported for billing accounts with agreement type Enterprise Agreement.
  • PATCHBillingProperty_Update/subscriptions/:subscriptionId/providers/Microsoft.Billing/billingProperty/default?api-version=stringUpdates the billing property of a subscription. Currently, cost center can be updated. The operation is supported only for billing accounts with agreement…

BillingRoleDefinitions

  • GETBillingRoleDefinitions_GetByBillingAccount/providers/Microsoft.Billing/billingAccounts/:billingAccountName/billingRoleDefinitions/:billingRoleDefinitionName?api-version=stringGets the definition for a role on a billing account. The operation is supported for billing accounts with agreement type Microsoft Partner Agreement or…
  • GETBillingRoleDefinitions_GetByInvoiceSection/providers/Microsoft.Billing/billingAccounts/:billingAccountName/billingProfiles/:billingProfileName/invoiceSections/:invoiceSectionName/billingRoleDefinitions/:billingRoleDefinitionName?api-version=stringGets the definition for a role on an invoice section. The operation is supported only for billing accounts with agreement type Microsoft Customer Agreement.
  • GETBillingRoleDefinitions_GetByBillingProfile/providers/Microsoft.Billing/billingAccounts/:billingAccountName/billingProfiles/:billingProfileName/billingRoleDefinitions/:billingRoleDefinitionName?api-version=stringGets the definition for a role on a billing profile. The operation is supported for billing accounts with agreement type Microsoft Partner Agreement or…
  • GETBillingRoleDefinitions_ListByBillingAccount/providers/Microsoft.Billing/billingAccounts/:billingAccountName/billingRoleDefinitions?api-version=stringLists the role definitions for a billing account. The operation is supported for billing accounts with agreement type Microsoft Partner Agreement or Microsoft…
  • GETBillingRoleDefinitions_ListByInvoiceSection/providers/Microsoft.Billing/billingAccounts/:billingAccountName/billingProfiles/:billingProfileName/invoiceSections/:invoiceSectionName/billingRoleDefinitions?api-version=stringLists the role definitions for an invoice section. The operation is supported for billing accounts with agreement type Microsoft Partner Agreement or…
  • GETBillingRoleDefinitions_ListByBillingProfile/providers/Microsoft.Billing/billingAccounts/:billingAccountName/billingProfiles/:billingProfileName/billingRoleDefinitions?api-version=stringLists the role definitions for a billing profile. The operation is supported for billing accounts with agreement type Microsoft Partner Agreement or Microsoft…

BillingRoleAssignments

  • GETBillingRoleAssignments_GetByBillingAccount/providers/Microsoft.Billing/billingAccounts/:billingAccountName/billingRoleAssignments/:billingRoleAssignmentName?api-version=stringGets a role assignment for the caller on a billing account. The operation is supported for billing accounts with agreement type Microsoft Partner Agreement or…
  • DELETEBillingRoleAssignments_DeleteByBillingAccount/providers/Microsoft.Billing/billingAccounts/:billingAccountName/billingRoleAssignments/:billingRoleAssignmentName?api-version=stringDeletes a role assignment for the caller on a billing account. The operation is supported for billing accounts with agreement type Microsoft Partner Agreement…
  • GETBillingRoleAssignments_GetByInvoiceSection/providers/Microsoft.Billing/billingAccounts/:billingAccountName/billingProfiles/:billingProfileName/invoiceSections/:invoiceSectionName/billingRoleAssignments/:billingRoleAssignmentName?api-version=stringGets a role assignment for the caller on an invoice section. The operation is supported for billing accounts with agreement type Microsoft Customer Agreement.
  • DELETEBillingRoleAssignments_DeleteByInvoiceSection/providers/Microsoft.Billing/billingAccounts/:billingAccountName/billingProfiles/:billingProfileName/invoiceSections/:invoiceSectionName/billingRoleAssignments/:billingRoleAssignmentName?api-version=stringDeletes a role assignment for the caller on an invoice section. The operation is supported for billing accounts with agreement type Microsoft Customer…
  • GETBillingRoleAssignments_GetByBillingProfile/providers/Microsoft.Billing/billingAccounts/:billingAccountName/billingProfiles/:billingProfileName/billingRoleAssignments/:billingRoleAssignmentName?api-version=stringGets a role assignment for the caller on a billing profile. The operation is supported for billing accounts with agreement type Microsoft Partner Agreement or…
  • DELETEBillingRoleAssignments_DeleteByBillingProfile/providers/Microsoft.Billing/billingAccounts/:billingAccountName/billingProfiles/:billingProfileName/billingRoleAssignments/:billingRoleAssignmentName?api-version=stringDeletes a role assignment for the caller on a billing profile. The operation is supported for billing accounts with agreement type Microsoft Partner Agreement…
  • GETBillingRoleAssignments_ListByBillingAccount/providers/Microsoft.Billing/billingAccounts/:billingAccountName/billingRoleAssignments?api-version=stringLists the role assignments for the caller on a billing account. The operation is supported for billing accounts with agreement type Microsoft Partner…
  • GETBillingRoleAssignments_ListByInvoiceSection/providers/Microsoft.Billing/billingAccounts/:billingAccountName/billingProfiles/:billingProfileName/invoiceSections/:invoiceSectionName/billingRoleAssignments?api-version=stringLists the role assignments for the caller on an invoice section. The operation is supported for billing accounts with agreement type Microsoft Customer…
  • GETBillingRoleAssignments_ListByBillingProfile/providers/Microsoft.Billing/billingAccounts/:billingAccountName/billingProfiles/:billingProfileName/billingRoleAssignments?api-version=stringLists the role assignments for the caller on a billing profile. The operation is supported for billing accounts with agreement type Microsoft Customer…

Agreements

  • GETAgreements_ListByBillingAccount/providers/Microsoft.Billing/billingAccounts/:billingAccountName/agreements?api-version=string&$expand=stringLists the agreements for a billing account.
  • GETAgreements_Get/providers/Microsoft.Billing/billingAccounts/:billingAccountName/agreements/:agreementName?api-version=string&$expand=stringGets an agreement by ID.

Reservations

  • GETReservations_ListByBillingAccount/providers/Microsoft.Billing/billingAccounts/:billingAccountName/reservations?api-version=string&$filter=string&$orderby=string&refreshSummary=string&selectedState=stringLists the reservations for a billing account and the roll up counts of reservations group by provisioning states.
  • GETReservations_ListByBillingProfile/providers/Microsoft.Billing/billingAccounts/:billingAccountName/billingProfiles/:billingProfileName/reservations?api-version=string&$filter=string&$orderby=string&refreshSummary=string&selectedState=stringLists the reservations for a billing profile and the roll up counts of reservations group by provisioning state.
  • POSTBillingSubscriptions_Move/providers/Microsoft.Billing/billingAccounts/:billingAccountName/billingSubscriptions/:subscriptionId/move?api-version=stringMoves a subscription's charges to a new invoice section. The new invoice section must belong to the same billing profile as the existing invoice section. This…
  • POSTBillingSubscriptions_ValidateMove/providers/Microsoft.Billing/billingAccounts/:billingAccountName/billingSubscriptions/:subscriptionId/validateMoveEligibility?api-version=stringValidates if a subscription's charges can be moved to a new invoice section. This operation is supported for billing accounts with agreement type Microsoft…
  • POSTProducts_ValidateMove/providers/Microsoft.Billing/billingAccounts/:billingAccountName/products/:productName/validateMoveEligibility?api-version=stringValidates if a product's charges can be moved to a new invoice section. This operation is supported only for products that are purchased with a recurring…

API details

Base URL
https://management.azure.com
Authentication
OAuth 2.0 (implicit flow) with 1 scope
Operations
74 operations on 62 pathsGET 52POST 10PUT 5PATCH 4DELETE 3
Main resources
Invoices 10BillingRoleAssignments 9Products 7BillingRoleDefinitions 6BillingSubscriptions 6BillingAccounts 4BillingPermissions 4Policies 4BillingProfiles 3Customers 3
Response formats
application/json
Description format
Swagger 2.0, API version 2020-05-01

How to test the Azure Billing in Swastik Codes

  1. Open the APISelect “Fork & run in Swastik Codes” on this page. Sign in or create a free account if asked.
  2. Fork it into your workspaceChoose a workspace. You get your own copy of the Azure Billing collection, without the publisher's secrets.
  3. Add your credentialsThis API uses OAuth 2.0 (implicit flow) with 1 scope. Add yours in the collection's variables or an environment; the requests already reference it.
  4. Send a requestPick an endpoint, for example “BillingAccounts_List” (GET /providers/Microsoft.Billing/billingAccounts?api-version=string&$expand=string), and press Send. Check the response, add tests and run the whole collection with the runner.

Frequently asked questions

What is the Azure Billing?

Billing client provides access to billing resources for Azure subscriptions. It is listed under Finance & banking and has 74 endpoints.

Who publishes the Azure Billing?

It is listed from Microsoft Azure's public API description (an OpenAPI document), not published by Microsoft Azure on Swastik Codes. Anyone who controls azure.com can claim the profile by adding a DNS TXT record.

What is the base URL of the Azure Billing?

Requests go to https://management.azure.com. Endpoint paths are added to this base URL.

How do I authenticate with the Azure Billing?

With OAuth 2.0 (implicit flow) with 1 scope.

How many endpoints does the Azure Billing have?

74 operations on 62 paths (52 GET, 10 POST, 5 PUT, 4 PATCH, 3 DELETE). The largest groups are Invoices, BillingRoleAssignments, Products, BillingRoleDefinitions.

Is forking the Azure Billing free?

Yes. Forking copies the collection into your workspace for free. It has been starred 0 times and forked 0 times.

Suggest an API

Tell us which public API is missing. We check it, then add it here with its endpoints when it has an OpenAPI (Swagger) description.