---
title: "POST /list-pricing-rules"
method: POST
path: "/list-pricing-rules"
---

# POST /list-pricing-rules

`POST /list-pricing-rules`

Describes a pricing rule that can be associated to a pricing plan, or set of pricing plans.

## Request body

- object
  - `BillingPeriod` string — The preferred billing period to get the pricing plan.
  - `Filters` object — The filter that specifies criteria that the pricing rules returned by the <code>ListPricingRules</code> API will adhere to.
    - `Arns` PricingRuleArn[] — A list containing the pricing rule Amazon Resource Names (ARNs) to include in the API response.
  - `MaxResults` integer — The maximum number of pricing rules to retrieve.
  - `NextToken` string — The pagination token that's used on subsequent call to get pricing rules.

## Response `200`

Success

- ListPricingRulesOutput
  - `BillingPeriod` string — The billing period for which the described pricing rules are applicable.
  - `PricingRules` PricingRuleListElement[] — A list containing the described pricing rules.
    - `Name` string, password — The name of a pricing rule.
    - `Arn` string — The Amazon Resource Name (ARN) used to uniquely identify a pricing rule.
    - `Description` string, password — The pricing rule description.
    - `Scope` 'GLOBAL' | 'SERVICE' | 'BILLING_ENTITY' | 'SKU' — The scope of pricing rule that indicates if it is globally applicable, or if it is service-specific.
    - `Type` 'MARKUP' | 'DISCOUNT' | 'TIERING' — The type of pricing rule.
    - `ModifierPercentage` number, double — A percentage modifier applied on the public pricing rates.
    - `Service` string — If the <code>Scope</code> attribute is <code>SERVICE</code>, this attribute indicates which service the <code>PricingRule</code> is applicable for.
    - `AssociatedPricingPlanCount` integer — The pricing plans count that this pricing rule is associated with.
    - `CreationTime` integer — The time when the pricing rule was created.
    - `LastModifiedTime` integer — The most recent time when the pricing rule was modified.
    - `BillingEntity` string — The seller of services provided by Amazon Web Services, their affiliates, or third-party providers selling services via Amazon Web Services Marketplace.
    - `Tiering` object — The set of tiering configurations for the pricing rule.
      - `FreeTier` object, required — The possible Amazon Web Services Free Tier configurations.
        - `Activated` boolean, required — Activate or deactivate Amazon Web Services Free Tier application.
    - `UsageType` string — <p> Usage type is the unit that each service uses to measure the usage of a specific type of resource.</p> <p>If the <code>Scope</code> attribute is set to <code>SKU</code>, this attribute indicates which usage type the <code>PricingRule</code> is modifying. For example, <code>USW2-BoxUsage:m2.2xlarge</code> describes an<code> M2 High Memory Double Extra Large</code> instance in the US West (Oregon) Region. </p>
    - `Operation` string — <p> Operation is the specific Amazon Web Services action covered by this line item. This describes the specific usage of the line item.</p> <p> If the <code>Scope</code> attribute is set to <code>SKU</code>, this attribute indicates which operation the <code>PricingRule</code> is modifying. For example, a value of <code>RunInstances:0202</code> indicates the operation of running an Amazon EC2 instance.</p>
  - `NextToken` string — The pagination token that's used on subsequent calls to get pricing rules.

## Other responses

- `480` — ThrottlingException
- `481` — AccessDeniedException
- `482` — ValidationException
- `483` — InternalServerException

---

[API](https://skmtc.net/aws/apis/billingconductor.md) · [All operations](https://skmtc.net/aws/apis/billingconductor/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/aws/billingconductor/versions/2cc5849dea95/schema)