# Azure Billing benefits RP management API

> Azure Billing benefits RP management API on Apizie: 79 endpoints (List conditional credits that are applicable for a given scope. Currently supported scopes: billing accounts, List applicable credits for the provided scope. Currently supported scopes: BillingAccountResourceId, List discounts that are applicable for a given scope. Currently supported scopes: billing accounts, List catalog groups at the target scope., …) returned as clean JSON through one API key. Send your own provider key in the x-upstream-key header. Call it over REST at https://apizie.tech/v1/cloud:azure-arm-billingbenefits/{endpoint} or from Claude, ChatGPT and Cursor through the Apizie MCP server. Free plan: 1,000 requests a month.

- Project key: `cloud:azure-arm-billingbenefits`
- Category: Cloud
- Status: byok
- Source: https://learn.microsoft.com/rest/api/azure/
- Page: https://apizie.tech/api/cloud/azure-arm-billingbenefits
- OpenAPI: https://apizie.tech/api/cloud/azure-arm-billingbenefits/openapi.json

Azure Resource Manager API for Billing benefits RP: manage these Azure resources in your subscription with a Microsoft Entra access token.

## Endpoints

### List conditional credits that are applicable for a given scope. Currently supported scopes: billing accounts
`GET https://apizie.tech/v1/cloud:azure-arm-billingbenefits/conditional-credits-scope-list` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| api-version | string | no | The API version to use for this operation. |
| scope | string | yes | The scope at which the benefits are listed. |

### List applicable credits for the provided scope. Currently supported scopes: BillingAccountResourceId
`GET https://apizie.tech/v1/cloud:azure-arm-billingbenefits/credits-list-applicable` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| api-version | string | no | The API version to use for this operation. |
| scope | string | yes | The scope at which the benefits are listed. |

### List discounts that are applicable for a given scope. Currently supported scopes: billing accounts
`GET https://apizie.tech/v1/cloud:azure-arm-billingbenefits/discounts-scope-list` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| api-version | string | no | The API version to use for this operation. |
| scope | string | yes | The scope at which the benefits are listed. |

### List catalog groups at the target scope.
`GET https://apizie.tech/v1/cloud:azure-arm-billingbenefits/billing-profile-catalog-groups-ops-list` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| api-version | string | no | The API version to use for this operation. |
| billingAccountName | string | yes | The name of the billing account. |
| billingProfileName | string | yes | The name of the billing profile. |
| $filter | string | no | OData filter expression to narrow the list of catalog groups. |

### Get a specific catalog group at the target scope.
`GET https://apizie.tech/v1/cloud:azure-arm-billingbenefits/billing-profile-catalog-groups-ops-get` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| api-version | string | no | The API version to use for this operation. |
| billingAccountName | string | yes | The name of the billing account. |
| billingProfileName | string | yes | The name of the billing profile. |
| catalogGroupName | string | yes | The name of the CatalogGroup |

### List catalog groups at the target scope.
`GET https://apizie.tech/v1/cloud:azure-arm-billingbenefits/billing-account-catalog-groups-ops-list` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| api-version | string | no | The API version to use for this operation. |
| billingAccountName | string | yes | The name of the billing account. |
| $filter | string | no | OData filter expression to narrow the list of catalog groups. |

### Get a specific catalog group at the target scope.
`GET https://apizie.tech/v1/cloud:azure-arm-billingbenefits/billing-account-catalog-groups-ops-get` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| api-version | string | no | The API version to use for this operation. |
| billingAccountName | string | yes | The name of the billing account. |
| catalogGroupName | string | yes | The name of the CatalogGroup |

### List maccs by billing account
`POST https://apizie.tech/v1/cloud:azure-arm-billingbenefits/seller-resource-list` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| api-version | string | no | The API version to use for this operation. |
| body | object | yes | JSON request body |

### List the operations for the provider
`GET https://apizie.tech/v1/cloud:azure-arm-billingbenefits/operations-list` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| api-version | string | no | The API version to use for this operation. |

### Get a reservation order alias.
`GET https://apizie.tech/v1/cloud:azure-arm-billingbenefits/reservation-order-alias-get` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| api-version | string | no | The API version to use for this operation. |
| reservationOrderAliasName | string | yes | Name of the reservation order alias |

### Create a reservation order alias.
`POST https://apizie.tech/v1/cloud:azure-arm-billingbenefits/reservation-order-alias-create` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| api-version | string | no | The API version to use for this operation. |
| reservationOrderAliasName | string | yes | Name of the reservation order alias |
| body | object | yes | JSON request body |

### Get a savings plan.
`GET https://apizie.tech/v1/cloud:azure-arm-billingbenefits/savings-plan-order-alias-get` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| api-version | string | no | The API version to use for this operation. |
| savingsPlanOrderAliasName | string | yes | Name of the savings plan order alias |

### Create a savings plan. Learn more about permissions needed at https://go.microsoft.com/fwlink/?linkid=2215851
`POST https://apizie.tech/v1/cloud:azure-arm-billingbenefits/savings-plan-order-alias-create` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| api-version | string | no | The API version to use for this operation. |
| savingsPlanOrderAliasName | string | yes | Name of the savings plan order alias |
| body | object | yes | JSON request body |

### List all Savings plan orders.
`GET https://apizie.tech/v1/cloud:azure-arm-billingbenefits/savings-plan-order-list` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| api-version | string | no | The API version to use for this operation. |

### Get a savings plan order.
`GET https://apizie.tech/v1/cloud:azure-arm-billingbenefits/savings-plan-order-get` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| api-version | string | no | The API version to use for this operation. |
| savingsPlanOrderId | string | yes | Order ID of the savings plan |
| $expand | string | no | May be used to expand the detail information of some properties. |

### Elevate as owner on savings plan order based on billing permissions.
`POST https://apizie.tech/v1/cloud:azure-arm-billingbenefits/savings-plan-order-elevate` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| api-version | string | no | The API version to use for this operation. |
| savingsPlanOrderId | string | yes | Order ID of the savings plan |

### List savings plans in an order.
`GET https://apizie.tech/v1/cloud:azure-arm-billingbenefits/savings-plan-list` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| api-version | string | no | The API version to use for this operation. |
| savingsPlanOrderId | string | yes | Order ID of the savings plan |

### Get savings plan.
`GET https://apizie.tech/v1/cloud:azure-arm-billingbenefits/savings-plan-get` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| api-version | string | no | The API version to use for this operation. |
| savingsPlanOrderId | string | yes | Order ID of the savings plan |
| savingsPlanId | string | yes | ID of the savings plan |
| $expand | string | no | May be used to expand the detail information of some properties. |

### Update savings plan.
`POST https://apizie.tech/v1/cloud:azure-arm-billingbenefits/savings-plan-update` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| api-version | string | no | The API version to use for this operation. |
| savingsPlanOrderId | string | yes | Order ID of the savings plan |
| savingsPlanId | string | yes | ID of the savings plan |
| body | object | yes | JSON request body |

### Validate savings plan patch.
`POST https://apizie.tech/v1/cloud:azure-arm-billingbenefits/savings-plan-validate-update` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| api-version | string | no | The API version to use for this operation. |
| savingsPlanOrderId | string | yes | Order ID of the savings plan |
| savingsPlanId | string | yes | ID of the savings plan |
| body | object | yes | JSON request body |

### List savings plans.
`GET https://apizie.tech/v1/cloud:azure-arm-billingbenefits/savings-plan-list-all` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| api-version | string | no | The API version to use for this operation. |
| $filter | string | no | May be used to filter by reservation properties. The filter supports 'eq', 'or', and 'and'. It does not currently support 'ne', 'gt',… |
| $orderby | string | no | May be used to sort order by reservation properties. |
| refreshSummary | string | no | To indicate whether to refresh the roll up counts of the savings plans group by provisioning states |
| $skiptoken | number | no | The number of savings plans to skip from the list before returning results |
| selectedState | string | no | The selected provisioning state |
| take | number | no | To number of savings plans to return |

### Validate savings plan purchase.
`POST https://apizie.tech/v1/cloud:azure-arm-billingbenefits/benefit-validate` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| api-version | string | no | The API version to use for this operation. |
| body | object | yes | JSON request body |

### List contributors under applicable conditional credits for a given billing account.
`GET https://apizie.tech/v1/cloud:azure-arm-billingbenefits/conditional-credit-contributors-list-from-applicable-conditi` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| api-version | string | no | The API version to use for this operation. |
| billingAccountId | string | yes | The billing account Id at which the benefits are listed. Accepted format is: {rootId:orgId}. |
| systemId | string | yes | System ID of the primary MACC. |

### List maccs that are applicable for a given billing account.
`GET https://apizie.tech/v1/cloud:azure-arm-billingbenefits/applicable-maccs-list` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| api-version | string | no | The API version to use for this operation. |
| billingAccountId | string | yes | The billing account Id at which the benefits are listed. Accepted format is: {rootId:orgId}. |

### List contributors under applicable MACCs for a given billing account.
`GET https://apizie.tech/v1/cloud:azure-arm-billingbenefits/contributors-list-from-applicable-macc` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| api-version | string | no | The API version to use for this operation. |
| billingAccountId | string | yes | The billing account Id at which the benefits are listed. Accepted format is: {rootId:orgId}. |
| systemId | string | yes | System ID of the primary MACC. |

### List catalog groups at the target scope.
`GET https://apizie.tech/v1/cloud:azure-arm-billingbenefits/subscription-catalog-groups-ops-list` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| api-version | string | no | The API version to use for this operation. |
| subscriptionId | string | yes | The ID of the target subscription. The value must be an UUID. |
| $filter | string | no | OData filter expression to narrow the list of catalog groups. |

### Get a specific catalog group at the target scope.
`GET https://apizie.tech/v1/cloud:azure-arm-billingbenefits/subscription-catalog-groups-ops-get` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| api-version | string | no | The API version to use for this operation. |
| subscriptionId | string | yes | The ID of the target subscription. The value must be an UUID. |
| catalogGroupName | string | yes | The name of the CatalogGroup |

### List conditional credits by subscription.
`GET https://apizie.tech/v1/cloud:azure-arm-billingbenefits/conditional-credits-list-by-subscription` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| api-version | string | no | The API version to use for this operation. |
| subscriptionId | string | yes | The ID of the target subscription. The value must be an UUID. |

### List credits under a subscription from primary service tenant.
`GET https://apizie.tech/v1/cloud:azure-arm-billingbenefits/credits-list-by-subscription` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| api-version | string | no | The API version to use for this operation. |
| subscriptionId | string | yes | The ID of the target subscription. The value must be an UUID. |

### List discounts at subscription level
`GET https://apizie.tech/v1/cloud:azure-arm-billingbenefits/discounts-subscription-list` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| api-version | string | no | The API version to use for this operation. |
| subscriptionId | string | yes | The ID of the target subscription. The value must be an UUID. |

### This operation lists free services that are available under the specified subscription.
`GET https://apizie.tech/v1/cloud:azure-arm-billingbenefits/free-services-list-by-subscription` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| api-version | string | no | The API version to use for this operation. |
| subscriptionId | string | yes | The ID of the target subscription. The value must be an UUID. |

### List MACCs under a subscription from primary service tenant.
`GET https://apizie.tech/v1/cloud:azure-arm-billingbenefits/maccs-list-by-subscription` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| api-version | string | no | The API version to use for this operation. |
| subscriptionId | string | yes | The ID of the target subscription. The value must be an UUID. |

### List conditional credits by resource group.
`GET https://apizie.tech/v1/cloud:azure-arm-billingbenefits/conditional-credits-list-by-resource-group` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| api-version | string | no | The API version to use for this operation. |
| subscriptionId | string | yes | The ID of the target subscription. The value must be an UUID. |
| resourceGroupName | string | yes | The name of the resource group. The name is case insensitive. |

### Get a conditional credit.
`GET https://apizie.tech/v1/cloud:azure-arm-billingbenefits/conditional-credits-get` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| api-version | string | no | The API version to use for this operation. |
| subscriptionId | string | yes | The ID of the target subscription. The value must be an UUID. |
| resourceGroupName | string | yes | The name of the resource group. The name is case insensitive. |
| conditionalCreditName | string | yes | Name of the conditional credit |

### Create or update a conditional credit.
`POST https://apizie.tech/v1/cloud:azure-arm-billingbenefits/conditional-credits-create-or-update` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| api-version | string | no | The API version to use for this operation. |
| subscriptionId | string | yes | The ID of the target subscription. The value must be an UUID. |
| resourceGroupName | string | yes | The name of the resource group. The name is case insensitive. |
| conditionalCreditName | string | yes | Name of the conditional credit |
| body | object | yes | JSON request body |

### Update a conditional credit.
`POST https://apizie.tech/v1/cloud:azure-arm-billingbenefits/conditional-credits-update` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| api-version | string | no | The API version to use for this operation. |
| subscriptionId | string | yes | The ID of the target subscription. The value must be an UUID. |
| resourceGroupName | string | yes | The name of the resource group. The name is case insensitive. |
| conditionalCreditName | string | yes | Name of the conditional credit |
| body | object | yes | JSON request body |

### Delete a conditional credit.
`POST https://apizie.tech/v1/cloud:azure-arm-billingbenefits/conditional-credits-delete` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| api-version | string | no | The API version to use for this operation. |
| subscriptionId | string | yes | The ID of the target subscription. The value must be an UUID. |
| resourceGroupName | string | yes | The name of the resource group. The name is case insensitive. |
| conditionalCreditName | string | yes | Name of the conditional credit |

### Cancel conditional credit. Stops applying the benefit.
`POST https://apizie.tech/v1/cloud:azure-arm-billingbenefits/conditional-credits-cancel` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| api-version | string | no | The API version to use for this operation. |
| subscriptionId | string | yes | The ID of the target subscription. The value must be an UUID. |
| resourceGroupName | string | yes | The name of the resource group. The name is case insensitive. |
| conditionalCreditName | string | yes | Name of the conditional credit |

### List contributors under a primary conditional credit for primary service admin
`GET https://apizie.tech/v1/cloud:azure-arm-billingbenefits/conditional-credit-contributors-list-from-primary` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| api-version | string | no | The API version to use for this operation. |
| subscriptionId | string | yes | The ID of the target subscription. The value must be an UUID. |
| resourceGroupName | string | yes | The name of the resource group. The name is case insensitive. |
| conditionalCreditName | string | yes | Name of the conditional credit |

### Get a conditional credit contributor for primary service admin
`GET https://apizie.tech/v1/cloud:azure-arm-billingbenefits/conditional-credit-contributors-get-from-primary` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| api-version | string | no | The API version to use for this operation. |
| subscriptionId | string | yes | The ID of the target subscription. The value must be an UUID. |
| resourceGroupName | string | yes | The name of the resource group. The name is case insensitive. |
| conditionalCreditName | string | yes | Name of the conditional credit |
| contributorName | string | yes | Unique name of contributor in the format {contributorCloudSubId}_{resourceGroupName}_{nameInContributorTenant}. |

### List all transactions for a conditional credit.
`GET https://apizie.tech/v1/cloud:azure-arm-billingbenefits/conditional-credit-transactions-list-by-parent` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| api-version | string | no | The API version to use for this operation. |
| subscriptionId | string | yes | The ID of the target subscription. The value must be an UUID. |
| resourceGroupName | string | yes | The name of the resource group. The name is case insensitive. |
| conditionalCreditName | string | yes | Name of the conditional credit |

### Get a specific transaction for a conditional credit.
`GET https://apizie.tech/v1/cloud:azure-arm-billingbenefits/conditional-credit-transactions-get` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| api-version | string | no | The API version to use for this operation. |
| subscriptionId | string | yes | The ID of the target subscription. The value must be an UUID. |
| resourceGroupName | string | yes | The name of the resource group. The name is case insensitive. |
| conditionalCreditName | string | yes | Name of the conditional credit |
| transactionName | string | yes | Name of the transaction |

### List Credits under a resource group from primary service admin.
`GET https://apizie.tech/v1/cloud:azure-arm-billingbenefits/credits-list-by-resource-group` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| api-version | string | no | The API version to use for this operation. |
| subscriptionId | string | yes | The ID of the target subscription. The value must be an UUID. |
| resourceGroupName | string | yes | The name of the resource group. The name is case insensitive. |

### Get a credit.
`GET https://apizie.tech/v1/cloud:azure-arm-billingbenefits/credits-get` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| api-version | string | no | The API version to use for this operation. |
| subscriptionId | string | yes | The ID of the target subscription. The value must be an UUID. |
| resourceGroupName | string | yes | The name of the resource group. The name is case insensitive. |
| creditName | string | yes | Name of the credit |

### Create a credit.
`POST https://apizie.tech/v1/cloud:azure-arm-billingbenefits/credits-create` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| api-version | string | no | The API version to use for this operation. |
| subscriptionId | string | yes | The ID of the target subscription. The value must be an UUID. |
| resourceGroupName | string | yes | The name of the resource group. The name is case insensitive. |
| creditName | string | yes | Name of the credit |
| body | object | yes | JSON request body |

### Update a credit.
`POST https://apizie.tech/v1/cloud:azure-arm-billingbenefits/credits-update` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| api-version | string | no | The API version to use for this operation. |
| subscriptionId | string | yes | The ID of the target subscription. The value must be an UUID. |
| resourceGroupName | string | yes | The name of the resource group. The name is case insensitive. |
| creditName | string | yes | Name of the credit |
| body | object | yes | JSON request body |

### Delete a credit.
`POST https://apizie.tech/v1/cloud:azure-arm-billingbenefits/credits-delete` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| api-version | string | no | The API version to use for this operation. |
| subscriptionId | string | yes | The ID of the target subscription. The value must be an UUID. |
| resourceGroupName | string | yes | The name of the resource group. The name is case insensitive. |
| creditName | string | yes | Name of the credit |

### Cancels a credit.
`POST https://apizie.tech/v1/cloud:azure-arm-billingbenefits/credits-cancel` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| api-version | string | no | The API version to use for this operation. |
| subscriptionId | string | yes | The ID of the target subscription. The value must be an UUID. |
| resourceGroupName | string | yes | The name of the resource group. The name is case insensitive. |
| creditName | string | yes | Name of the credit |

### Change the sponsor of a credit.
`POST https://apizie.tech/v1/cloud:azure-arm-billingbenefits/credits-change-sponsor` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| api-version | string | no | The API version to use for this operation. |
| subscriptionId | string | yes | The ID of the target subscription. The value must be an UUID. |
| resourceGroupName | string | yes | The name of the resource group. The name is case insensitive. |
| creditName | string | yes | Name of the credit |
| body | object | yes | JSON request body |

### List credit sources for a credit under a resource group from primary service admin.
`GET https://apizie.tech/v1/cloud:azure-arm-billingbenefits/sources-list-by-credit` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| api-version | string | no | The API version to use for this operation. |
| subscriptionId | string | yes | The ID of the target subscription. The value must be an UUID. |
| resourceGroupName | string | yes | The name of the resource group. The name is case insensitive. |
| creditName | string | yes | Name of the credit |

### Get a credit source.
`GET https://apizie.tech/v1/cloud:azure-arm-billingbenefits/sources-get` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| api-version | string | no | The API version to use for this operation. |
| subscriptionId | string | yes | The ID of the target subscription. The value must be an UUID. |
| resourceGroupName | string | yes | The name of the resource group. The name is case insensitive. |
| creditName | string | yes | Name of the credit |
| sourceName | string | yes | Name of the credit source |

### Create a credit source.
`POST https://apizie.tech/v1/cloud:azure-arm-billingbenefits/sources-create` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| api-version | string | no | The API version to use for this operation. |
| subscriptionId | string | yes | The ID of the target subscription. The value must be an UUID. |
| resourceGroupName | string | yes | The name of the resource group. The name is case insensitive. |
| creditName | string | yes | Name of the credit |
| sourceName | string | yes | Name of the credit source |
| body | object | yes | JSON request body |

### Update a credit source.
`POST https://apizie.tech/v1/cloud:azure-arm-billingbenefits/sources-update` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| api-version | string | no | The API version to use for this operation. |
| subscriptionId | string | yes | The ID of the target subscription. The value must be an UUID. |
| resourceGroupName | string | yes | The name of the resource group. The name is case insensitive. |
| creditName | string | yes | Name of the credit |
| sourceName | string | yes | Name of the credit source |
| body | object | yes | JSON request body |

### Delete a credit source.
`POST https://apizie.tech/v1/cloud:azure-arm-billingbenefits/sources-delete` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| api-version | string | no | The API version to use for this operation. |
| subscriptionId | string | yes | The ID of the target subscription. The value must be an UUID. |
| resourceGroupName | string | yes | The name of the resource group. The name is case insensitive. |
| creditName | string | yes | Name of the credit |
| sourceName | string | yes | Name of the credit source |

### List all transactions for a credit.
`GET https://apizie.tech/v1/cloud:azure-arm-billingbenefits/credit-transactions-list-by-parent` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| api-version | string | no | The API version to use for this operation. |
| subscriptionId | string | yes | The ID of the target subscription. The value must be an UUID. |
| resourceGroupName | string | yes | The name of the resource group. The name is case insensitive. |
| creditName | string | yes | Name of the credit |

### Get a specific transaction for a credit.
`GET https://apizie.tech/v1/cloud:azure-arm-billingbenefits/credit-transactions-get` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| api-version | string | no | The API version to use for this operation. |
| subscriptionId | string | yes | The ID of the target subscription. The value must be an UUID. |
| resourceGroupName | string | yes | The name of the resource group. The name is case insensitive. |
| creditName | string | yes | Name of the credit |
| transactionName | string | yes | Name of the transaction |

### List discounts at resource group level
`GET https://apizie.tech/v1/cloud:azure-arm-billingbenefits/discounts-resource-group-list` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| api-version | string | no | The API version to use for this operation. |
| subscriptionId | string | yes | The ID of the target subscription. The value must be an UUID. |
| resourceGroupName | string | yes | The name of the resource group. The name is case insensitive. |

### Get discount at resource group level
`GET https://apizie.tech/v1/cloud:azure-arm-billingbenefits/discount-get` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| api-version | string | no | The API version to use for this operation. |
| subscriptionId | string | yes | The ID of the target subscription. The value must be an UUID. |
| resourceGroupName | string | yes | The name of the resource group. The name is case insensitive. |
| discountName | string | yes | Name of the discount |

### Create discount.
`POST https://apizie.tech/v1/cloud:azure-arm-billingbenefits/discounts-create` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| api-version | string | no | The API version to use for this operation. |
| subscriptionId | string | yes | The ID of the target subscription. The value must be an UUID. |
| resourceGroupName | string | yes | The name of the resource group. The name is case insensitive. |
| discountName | string | yes | Name of the discount |
| body | object | yes | JSON request body |

### Update discounts
`POST https://apizie.tech/v1/cloud:azure-arm-billingbenefits/discount-update` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| api-version | string | no | The API version to use for this operation. |
| subscriptionId | string | yes | The ID of the target subscription. The value must be an UUID. |
| resourceGroupName | string | yes | The name of the resource group. The name is case insensitive. |
| discountName | string | yes | Name of the discount |
| body | object | yes | JSON request body |

### Delete discount. Clears the metadata from the user's view.
`POST https://apizie.tech/v1/cloud:azure-arm-billingbenefits/discounts-delete` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| api-version | string | no | The API version to use for this operation. |
| subscriptionId | string | yes | The ID of the target subscription. The value must be an UUID. |
| resourceGroupName | string | yes | The name of the resource group. The name is case insensitive. |
| discountName | string | yes | Name of the discount |

### Cancel discount. Stops applying the benefit.
`POST https://apizie.tech/v1/cloud:azure-arm-billingbenefits/discounts-cancel` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| api-version | string | no | The API version to use for this operation. |
| subscriptionId | string | yes | The ID of the target subscription. The value must be an UUID. |
| resourceGroupName | string | yes | The name of the resource group. The name is case insensitive. |
| discountName | string | yes | Name of the discount |

### This operation lists the free services that are available under the specified resource group.
`GET https://apizie.tech/v1/cloud:azure-arm-billingbenefits/free-services-list-by-resource-group` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| api-version | string | no | The API version to use for this operation. |
| subscriptionId | string | yes | The ID of the target subscription. The value must be an UUID. |
| resourceGroupName | string | yes | The name of the resource group. The name is case insensitive. |

### This operation retrieves properties for free services.
`GET https://apizie.tech/v1/cloud:azure-arm-billingbenefits/free-services-get` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| api-version | string | no | The API version to use for this operation. |
| subscriptionId | string | yes | The ID of the target subscription. The value must be an UUID. |
| resourceGroupName | string | yes | The name of the resource group. The name is case insensitive. |
| freeServiceName | string | yes | Name of the free service |

### This operation creates or updates free services in Azure
`POST https://apizie.tech/v1/cloud:azure-arm-billingbenefits/free-services-create` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| api-version | string | no | The API version to use for this operation. |
| subscriptionId | string | yes | The ID of the target subscription. The value must be an UUID. |
| resourceGroupName | string | yes | The name of the resource group. The name is case insensitive. |
| freeServiceName | string | yes | Name of the free service |
| body | object | yes | JSON request body |

### This operation updates free services in Azure.
`POST https://apizie.tech/v1/cloud:azure-arm-billingbenefits/free-services-update` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| api-version | string | no | The API version to use for this operation. |
| subscriptionId | string | yes | The ID of the target subscription. The value must be an UUID. |
| resourceGroupName | string | yes | The name of the resource group. The name is case insensitive. |
| freeServiceName | string | yes | Name of the free service |
| body | object | yes | JSON request body |

### This operation deletes free services from the subscription. Only free services that are in an expired or…
`POST https://apizie.tech/v1/cloud:azure-arm-billingbenefits/free-services-delete` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| api-version | string | no | The API version to use for this operation. |
| subscriptionId | string | yes | The ID of the target subscription. The value must be an UUID. |
| resourceGroupName | string | yes | The name of the resource group. The name is case insensitive. |
| freeServiceName | string | yes | Name of the free service |

### List MACCs under a resource group for primary service admin.
`GET https://apizie.tech/v1/cloud:azure-arm-billingbenefits/maccs-list-by-resource-group` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| api-version | string | no | The API version to use for this operation. |
| subscriptionId | string | yes | The ID of the target subscription. The value must be an UUID. |
| resourceGroupName | string | yes | The name of the resource group. The name is case insensitive. |

### Get a MACC.
`GET https://apizie.tech/v1/cloud:azure-arm-billingbenefits/maccs-get` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| api-version | string | no | The API version to use for this operation. |
| subscriptionId | string | yes | The ID of the target subscription. The value must be an UUID. |
| resourceGroupName | string | yes | The name of the resource group. The name is case insensitive. |
| maccName | string | yes | Name of primary MACC. |

### Create MACC.
`POST https://apizie.tech/v1/cloud:azure-arm-billingbenefits/maccs-create` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| api-version | string | no | The API version to use for this operation. |
| subscriptionId | string | yes | The ID of the target subscription. The value must be an UUID. |
| resourceGroupName | string | yes | The name of the resource group. The name is case insensitive. |
| maccName | string | yes | Name of primary MACC. |
| body | object | yes | JSON request body |

### Update MACC.
`POST https://apizie.tech/v1/cloud:azure-arm-billingbenefits/maccs-update` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| api-version | string | no | The API version to use for this operation. |
| subscriptionId | string | yes | The ID of the target subscription. The value must be an UUID. |
| resourceGroupName | string | yes | The name of the resource group. The name is case insensitive. |
| maccName | string | yes | Name of primary MACC. |
| body | object | yes | JSON request body |

### Delete MACC.
`POST https://apizie.tech/v1/cloud:azure-arm-billingbenefits/maccs-delete` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| api-version | string | no | The API version to use for this operation. |
| subscriptionId | string | yes | The ID of the target subscription. The value must be an UUID. |
| resourceGroupName | string | yes | The name of the resource group. The name is case insensitive. |
| maccName | string | yes | Name of primary MACC. |

### Represents an operation to cancel MACC contract. This operation does not indicate deletion of the MACC, but…
`POST https://apizie.tech/v1/cloud:azure-arm-billingbenefits/maccs-cancel` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| api-version | string | no | The API version to use for this operation. |
| subscriptionId | string | yes | The ID of the target subscription. The value must be an UUID. |
| resourceGroupName | string | yes | The name of the resource group. The name is case insensitive. |
| maccName | string | yes | Name of primary MACC. |

### Operation to charge shortfall to a customer's account, ensuring they are charged for the outstanding amount…
`POST https://apizie.tech/v1/cloud:azure-arm-billingbenefits/maccs-charge-shortfall` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| api-version | string | no | The API version to use for this operation. |
| subscriptionId | string | yes | The ID of the target subscription. The value must be an UUID. |
| resourceGroupName | string | yes | The name of the resource group. The name is case insensitive. |
| maccName | string | yes | Name of primary MACC. |
| body | object | yes | JSON request body |

### List contributors under a MACC for primary service admin
`GET https://apizie.tech/v1/cloud:azure-arm-billingbenefits/contributors-list-from-primary` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| api-version | string | no | The API version to use for this operation. |
| subscriptionId | string | yes | The ID of the target subscription. The value must be an UUID. |
| resourceGroupName | string | yes | The name of the resource group. The name is case insensitive. |
| maccName | string | yes | Name of primary MACC. |

### Get a contributor for primary service admin
`GET https://apizie.tech/v1/cloud:azure-arm-billingbenefits/contributors-get-from-primary` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| api-version | string | no | The API version to use for this operation. |
| subscriptionId | string | yes | The ID of the target subscription. The value must be an UUID. |
| resourceGroupName | string | yes | The name of the resource group. The name is case insensitive. |
| maccName | string | yes | Name of primary MACC. |
| contributorName | string | yes | Unique name of contributor in the format {contributorCloudSubId}_{resourceGroupName}_{nameInContributorTenant}. |

### List all transactions for a MACC.
`GET https://apizie.tech/v1/cloud:azure-arm-billingbenefits/macc-transactions-list-by-parent` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| api-version | string | no | The API version to use for this operation. |
| subscriptionId | string | yes | The ID of the target subscription. The value must be an UUID. |
| resourceGroupName | string | yes | The name of the resource group. The name is case insensitive. |
| maccName | string | yes | Name of primary MACC. |

### Get a specific transaction for a MACC.
`GET https://apizie.tech/v1/cloud:azure-arm-billingbenefits/macc-transactions-get` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| api-version | string | no | The API version to use for this operation. |
| subscriptionId | string | yes | The ID of the target subscription. The value must be an UUID. |
| resourceGroupName | string | yes | The name of the resource group. The name is case insensitive. |
| maccName | string | yes | Name of primary MACC. |
| transactionName | string | yes | Name of the transaction |

### Operation to waive a customer's pending MACC balance (Shortfall) from their account, ensuring they are not…
`POST https://apizie.tech/v1/cloud:azure-arm-billingbenefits/maccs-write-off` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| api-version | string | no | The API version to use for this operation. |
| subscriptionId | string | yes | The ID of the target subscription. The value must be an UUID. |
| resourceGroupName | string | yes | The name of the resource group. The name is case insensitive. |
| maccName | string | yes | Name of primary MACC. |

## Example
```
curl "https://apizie.tech/v1/cloud:azure-arm-billingbenefits/conditional-credits-scope-list" \
  -H "x-api-key: $APIZIE_KEY" \
  -H "x-upstream-key: $PROVIDER_KEY"
```

## FAQ

### How do I call the Azure Billing benefits RP management API?
Create a free Apizie key, then send GET https://apizie.tech/v1/cloud:azure-arm-billingbenefits/conditional-credits-scope-list with the header x-api-key. Every endpoint returns { project, data, timestamp }.

### Is the Azure Billing benefits RP management API free on Apizie?
Yes. The Free plan includes 1,000 requests a month at 100 requests a minute, no credit card. Azure Billing benefits RP management itself also needs your own key from azure.com.

### Can AI agents use the Azure Billing benefits RP management API?
Yes. Add the Apizie MCP server (https://apizie.tech/mcp) to Claude, ChatGPT, Cursor or VS Code, then ask in plain language. The agent calls run_scraper with project key cloud:azure-arm-billingbenefits.

### What is the status of the Azure Billing benefits RP management API?
Needs your own provider key (bring your own key)