---
title: "POST /list-custom-line-item-versions"
method: POST
path: "/list-custom-line-item-versions"
---

# POST /list-custom-line-item-versions

`POST /list-custom-line-item-versions`

A paginated call to get a list of all custom line item versions.

## Request body

- object
  - `Arn` string, required — The Amazon Resource Name (ARN) for the custom line item.
  - `MaxResults` integer — The maximum number of custom line item versions to retrieve.
  - `NextToken` string — The pagination token that's used on subsequent calls to retrieve custom line item versions.
  - `Filters` object — A filter that specifies the billing period range where the custom line item versions reside.
    - `BillingPeriodRange` object — The billing period range in which the custom line item version is applied.
      - `StartBillingPeriod` string — The inclusive start billing period that defines a billing period range where a custom line item version is applied.
      - `EndBillingPeriod` string — The exclusive end billing period that defines a billing period range where a custom line item version is applied.

## Response `200`

Success

- ListCustomLineItemVersionsOutput
  - `CustomLineItemVersions` CustomLineItemVersionListElement[] — A list of <code>CustomLineItemVersionListElements</code> that are received.
    - `Name` string, password — The name of the custom line item.
    - `ChargeDetails` ListCustomLineItemChargeDetails — A representation of the charge details of a custom line item.
      - `Flat` object — A <code>ListCustomLineItemFlatChargeDetails</code> that describes the charge details of a flat custom line item.
        - `ChargeValue` number, double, required — The custom line item's fixed charge value in USD.
      - `Percentage` object — A <code>ListCustomLineItemPercentageChargeDetails</code> that describes the charge details of a percentage custom line item.
        - `PercentageValue` number, double, required — The custom line item's percentage value. This will be multiplied against the combined value of its associated resources to determine its charge value.
      - `Type` 'CREDIT' | 'FEE', required — The type of the custom line item that indicates whether the charge is a <code>fee</code> or <code>credit</code>.
      - `LineItemFilters` LineItemFilter[] — A representation of the line item filter.
        - `Attribute` 'LINE_ITEM_TYPE' | 'SERVICE', required — The attribute of the line item filter. This specifies what attribute that you can filter on.
        - `MatchOption` 'NOT_EQUAL' | 'EQUAL', required — The match criteria of the line item filter. This parameter specifies whether not to include the resource value from the billing group total cost.
        - `Values` LineItemFilterValue[] — The values of the line item filter. This specifies the values to filter on. Currently, you can only exclude Savings Plans discounts.
        - `AttributeValues` AttributeValue[] — The values of the line item filter. This specifies the values to filter on.
    - `CurrencyCode` 'USD' | 'CNY' — The charge value currency of the custom line item.
    - `Description` string, password — The description of the custom line item.
    - `ProductCode` string — The product code that’s associated with the custom line item.
    - `BillingGroupArn` string — The Amazon Resource Name (ARN) of the billing group that the custom line item applies to.
    - `CreationTime` integer — The time when the custom line item version was created.
    - `LastModifiedTime` integer — The most recent time that the custom line item version was modified.
    - `AssociationSize` integer — The number of resources that are associated with the custom line item.
    - `StartBillingPeriod` string — The start billing period of the custom line item version.
    - `EndBillingPeriod` string — The end billing period of the custom line item version.
    - `Arn` string — A list of custom line item Amazon Resource Names (ARNs) to retrieve information.
    - `StartTime` integer — The inclusive start time.
    - `AccountId` string — The Amazon Web Services account in which this custom line item will be applied to.
    - `ComputationRule` 'ITEMIZED' | 'CONSOLIDATED' — The computation rule for a specific version of a custom line item, determining how charges are computed and reflected in the bill.
    - `PresentationDetails` object — Presentation configuration for a specific version of a custom line item, specifying how charges are displayed in the bill.
      - `Service` string, required — The service under which the custom line item charges will be presented. Must be a string between 1 and 128 characters matching the pattern "<code>^[a-zA-Z0-9]+$</code>".
  - `NextToken` string — The pagination token that's used on subsequent calls to retrieve custom line item versions.

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