---
title: "POST /list-custom-line-items"
method: POST
path: "/list-custom-line-items"
---

# POST /list-custom-line-items

`POST /list-custom-line-items`

A paginated call to get a list of all custom line items (FFLIs) 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 custom line items (FFLIs).
  - `MaxResults` integer — The maximum number of billing groups to retrieve.
  - `NextToken` string — The pagination token that's used on subsequent calls to get custom line items (FFLIs).
  - `Filters` object — A filter that specifies the custom line items and billing groups to retrieve FFLI information.
    - `Names` CustomLineItemName[] — A list of custom line items to retrieve information.
    - `BillingGroups` BillingGroupArn[] — The billing group Amazon Resource Names (ARNs) to retrieve information.
    - `Arns` CustomLineItemArn[] — A list of custom line item ARNs to retrieve information.
    - `AccountIds` AccountId[] — The Amazon Web Services accounts in which this custom line item will be applied to.

## Response `200`

Success

- ListCustomLineItemsOutput
  - `CustomLineItems` CustomLineItemListElement[] — A list of <code>FreeFormLineItemListElements</code> received.
    - `Arn` string — The Amazon Resource Names (ARNs) for custom line items.
    - `Name` string, password — The custom line item's name.
    - `ChargeDetails` object — A <code>ListCustomLineItemChargeDetails</code> that describes 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 custom line item's charge value currency. Only one of the valid values can be used.
    - `Description` string, password — The custom line item's description. This is shown on the Bills page in association with the charge value.
    - `ProductCode` string — The product code that's associated with the custom line item.
    - `BillingGroupArn` string — The Amazon Resource Name (ARN) that references the billing group where the custom line item applies to.
    - `CreationTime` integer — The time created.
    - `LastModifiedTime` integer — The most recent time when the custom line item was modified.
    - `AssociationSize` integer — The number of resources that are associated to the custom line item.
    - `AccountId` string — The Amazon Web Services account in which this custom line item will be applied to.
    - `ComputationRule` 'ITEMIZED' | 'CONSOLIDATED' — The computation rule that determines how the custom line item charges are computed and reflected in the bill.
    - `PresentationDetails` object — Configuration details specifying how the custom line item charges are presented, including which service the charges are shown under.
      - `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 get custom line items (FFLIs).

## Other responses

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

---

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