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

# POST /list-pricing-plans

`POST /list-pricing-plans`

A paginated call to get pricing plans for the given billing period. If you don't provide a billing period, the current billing period is used.

## Request body

- object
  - `BillingPeriod` string — The preferred billing period to get pricing plan.
  - `Filters` object — The filter that specifies the Amazon Resource Names (ARNs) of pricing plans, to retrieve pricing plan information.
    - `Arns` PricingPlanArn[] — A list of pricing plan Amazon Resource Names (ARNs) to retrieve information.
  - `MaxResults` integer — The maximum number of pricing plans to retrieve.
  - `NextToken` string — The pagination token that's used on subsequent call to get pricing plans.

## Response `200`

Success

- ListPricingPlansOutput
  - `BillingPeriod` string — The billing period for which the described pricing plans are applicable.
  - `PricingPlans` PricingPlanListElement[] — A list of <code>PricingPlanListElement</code> retrieved.
    - `Name` string, password — The name of a pricing plan.
    - `Arn` string — The pricing plan Amazon Resource Names (ARN). This can be used to uniquely identify a pricing plan.
    - `Description` string, password — The pricing plan description.
    - `Size` integer — The pricing rules count that's currently associated with this pricing plan list element.
    - `CreationTime` integer — The time when the pricing plan was created.
    - `LastModifiedTime` integer — The most recent time when the pricing plan was modified.
  - `NextToken` string — The pagination token that's used on subsequent calls to get pricing plans.

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