---
title: "GET /providers/Microsoft.Billing/billingAccounts/{billingAccountName}/billingProfiles/{billingProfileName}/invoiceSections/{invoiceSectionName}/transactions"
method: GET
path: "/providers/Microsoft.Billing/billingAccounts/{billingAccountName}/billingProfiles/{billingProfileName}/invoiceSections/{invoiceSectionName}/transactions"
tags: ["Transactions"]
---

# GET /providers/Microsoft.Billing/billingAccounts/{billingAccountName}/billingProfiles/{billingProfileName}/invoiceSections/{invoiceSectionName}/transactions

`GET /providers/Microsoft.Billing/billingAccounts/{billingAccountName}/billingProfiles/{billingProfileName}/invoiceSections/{invoiceSectionName}/transactions`

## Request

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

Lists the billed and unbilled transactions by invoice section name for given start date and end date. Transactions include purchases, refunds and Azure usage charges. Unbilled transactions are listed under pending invoice Id and do not include tax. Tax is added to the amount once an invoice is generated.

## Path parameters

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

## Query parameters

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

## Response `200`

OK. The request has succeeded.

- TransactionListResult: The list of transactions.
  - `value` Transaction[]: The list of transactions.
    - `id` string: Resource Id.
    - `name` string: Resource name.
    - `type` string: Resource type.
    - `properties` TransactionProperties: The properties of a transaction.
      - `kind` 'all' | 'reservation': The kind of transaction. Options are all or reservation.
      - `date` string, date-time: The date of transaction.
      - `invoice` string: Invoice on which the transaction was billed or 'pending' if the transaction is not billed.
      - `orderId` string: The order ID of the reservation. The field is only applicable for transaction of kind reservation.
      - `orderName` string: The name of the reservation order. The field is only applicable for transactions of kind reservation.
      - `productFamily` string: The family of the product for which the transaction took place.
      - `productTypeId` string: The ID of the product type for which the transaction took place.
      - `productType` string: The type of the product for which the transaction took place.
      - `productDescription` string: The description of the product for which the transaction took place.
      - `transactionType` 'Purchase' | 'Usage Charge': The type of transaction.
      - `transactionAmount` Amount: The amount.
        - `currency` string: The currency for the amount value.
        - `value` number: Amount value.
      - `quantity` integer: The quantity purchased in the transaction.
      - `invoiceSectionId` string: The ID of the invoice section which will be billed for the transaction.
      - `invoiceSectionDisplayName` string: The name of the invoice section which will be billed for the transaction.
      - `billingProfileId` string: The ID of the billing profile which will be billed for the transaction.
      - `billingProfileDisplayName` string: The name of the billing profile which will be billed for the transaction.
      - `customerId` string: The ID of the customer for which the transaction took place. The field is applicable only for Microsoft Partner Agreement billing account.
      - `customerDisplayName` string: The name of the customer for which the transaction took place. The field is applicable only for Microsoft Partner Agreement billing account.
      - `subscriptionId` string: The ID of the subscription that was used for the transaction. The field is only applicable for transaction of kind reservation.
      - `subscriptionName` string: The name of the subscription that was used for the transaction. The field is only applicable for transaction of kind reservation.
      - `azureCreditApplied` Amount: The amount.
        - `currency` string: The currency for the amount value.
        - `value` number: Amount value.
      - `billingCurrency` string: The ISO 4217 code for the currency in which this transaction is billed.
      - `discount` number: The percentage discount, if any, applied to this transaction.
      - `effectivePrice` Amount: The amount.
        - `currency` string: The currency for the amount value.
        - `value` number: Amount value.
      - `exchangeRate` number: The exchange rate used to convert charged amount to billing currency, if applicable.
      - `marketPrice` Amount: The amount.
        - `currency` string: The currency for the amount value.
        - `value` number: Amount value.
      - `pricingCurrency` string: The ISO 4217 code for the currency in which the product is priced.
      - `servicePeriodStartDate` string, date-time: The date of the purchase of the product, or the start date of the month in which usage started.
      - `servicePeriodEndDate` string, date-time: The end date of the product term, or the end date of the month in which usage ended.
      - `subTotal` Amount: The amount.
        - `currency` string: The currency for the amount value.
        - `value` number: Amount value.
      - `tax` Amount: The amount.
        - `currency` string: The currency for the amount value.
        - `value` number: Amount value.
      - `unitOfMeasure` string: The unit of measure used to bill for the product. For example, compute services are billed per hour.
      - `units` number: The number of units used for a given product.
      - `unitType` string: The description for the unit of measure for a given product.
  - `nextLink` string: The link (url) to the next page of results.

## Other responses

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

## Changes

- **2019-11-20** (2019-10-01-preview) `bb97d4b1558c`: 2 breaking, 2 warning
  - added the new required `query` request parameter `periodEndDate`
  - added the new required `query` request parameter `periodStartDate`
  - deleted the `query` request parameter `endDate`
  - deleted the `query` request parameter `startDate`
- **2019-08-14** (2019-10-01-preview) `4ff6e8983572`: 1 info
  - api operation id `Transactions_ListByInvoiceSectionName` removed and replaced with `Transactions_ListByInvoiceSection`

[Operation history](https://skmtc.dev/azure/apis/billingmanagementclient/changes/providers/Microsoft.Billing/billingAccounts/:billingAccountName/billingProfiles/:billingProfileName/invoiceSections/:invoiceSectionName/transactions/get.md)

---

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