---
title: "Changes to Search subscription line items"
method: POST
path: "/subscriptions/lineitems/search"
---

# Changes to Search subscription line items

`POST /subscriptions/lineitems/search`

> Every recorded change to this operation, newest first.

## Timeline

Changed in 16 of 139 revisions.

- **2026-09-01** `e1d4e27b5677`: 1 info
- **2026-08-24** `9cd0dab91f5c`: 1 info
- **2026-08-24** `66536658bde6`: 1 info
- **2026-08-21** `d567e8585c2e`: 1 warning
- **2026-08-21** `edf928b9b745`: 1 info
- **2026-07-31** `50b7421a9690`: 1 info
- **2026-07-15** `f8ecf435d25d`: 3 warning, 2 info
- **2026-07-09** `646d6658479b`: 3 breaking, 1 info
- **2026-07-09** `7d57386313c7`: 25 breaking, 35 warning, 49 info
- **2026-07-09** `4b1a811c4179`: 46 breaking, 48 warning, 35 info
- **2026-06-24** `774ba8074d08`: 1 info
- **2026-06-16** `257509e66883`: 6 info
- **2026-06-10** `2a40f94de722`: 1 info
- **2026-06-03** `7adf4f33ea1a`: 1 info
- **2026-05-18** `8ec2edea6b20`: 4 warning
- **2026-05-13** `7934fabd26c1`: 1 info

## Changes

- **2026-09-01** `e1d4e27b5677`: 1 info
  - added the optional property `items/items/price/bucket_size` to the response with the `200` status
- **2026-08-24** `9cd0dab91f5c`: 1 info
  - added the optional property `items/items/price/plan/price_sync_status` to the response with the `200` status
- **2026-08-24** `66536658bde6`: 1 info
  - added the optional property `items/items/price/feature` to the response with the `200` status
- **2026-08-21** `d567e8585c2e`: 1 warning
  - removed the optional property `items/items/price/plan/price_sync_status` from the response with the `200` status
- **2026-08-21** `edf928b9b745`: 1 info
  - added the optional property `items/items/price/plan/price_sync_status` to the response with the `200` status
- **2026-07-31** `50b7421a9690`: 1 info
  - added the optional property `items/items/meter` to the response with the `200` status
- **2026-07-15** `f8ecf435d25d`: 3 warning, 2 info
  - added the new `ADDON` enum value to the `items/items/price/plan/credit_grants/items/scope` response property for the response status `200`
  - added the new `not_implemented` enum value to the `code` response property for the response status `400`
  - added the new `not_implemented` enum value to the `code` response property for the response status `500`
  - added the new `gte` enum value to the request property `filters/items/operator`
  - added the optional property `items/items/price/plan/credit_grants/items/addon_id` to the response with the `200` status
- **2026-07-09** `646d6658479b`: 3 breaking, 1 info
  - the `current_period_start` request property format changed from no format to `date-time`
  - the `end_time` request property format changed from no format to `date-time`
  - the `start_time` request property format changed from no format to `date-time`
  - the `billing_period_count` response's property default value `1` was removed for the status `200`
- **2026-07-09** `7d57386313c7`: 25 breaking, 35 warning, 49 info
  - the request's body type changed from no type to `object`
  - the `items/items/commitment_time_buckets/items/` response's property type changed from no type to `object` for status `200`
  - the `items/items/entity_type` response's property type changed from no type to `string` for status `200`
  - the `items/items/invoice_cadence` response's property type changed from no type to `string` for status `200`
  - the `items/items/price/entity_type` response's property type changed from no type to `string` for status `200`
  - the `items/items/price/invoice_cadence` response's property type changed from no type to `string` for status `200`
  - the `items/items/price/metadata` response's property type changed from no type to `object` for status `200`
  - the `items/items/price/meter/aggregation` response's property type changed from no type to `object` for status `200`
  - the `items/items/price/meter/filters/items/` response's property type changed from no type to `object` for status `200`
  - the `items/items/price/meter/reset_usage` response's property type changed from no type to `string` for status `200`
  - the `items/items/price/plan/credit_grants/items/metadata` response's property type changed from no type to `object` for status `200`
  - the `items/items/price/plan/credit_grants/items/status` response's property type changed from no type to `string` for status `200`
  - the `items/items/price/plan/metadata` response's property type changed from no type to `object` for status `200`
  - the `items/items/price/plan/status` response's property type changed from no type to `string` for status `200`
  - the `items/items/price/price_unit_tiers/items/` response's property type changed from no type to `object` for status `200`
  - the `items/items/price/price_unit_type` response's property type changed from no type to `string` for status `200`
  - the `items/items/price/pricing_unit/metadata` response's property type changed from no type to `object` for status `200`
  - the `items/items/price/pricing_unit/status` response's property type changed from no type to `string` for status `200`
  - the `items/items/price/status` response's property type changed from no type to `string` for status `200`
  - the `items/items/price/tiers/items/` response's property type changed from no type to `object` for status `200`
  - the `items/items/price/transform_quantity` response's property type changed from no type to `object` for status `200`
  - the `items/items/price/type` response's property type changed from no type to `string` for status `200`
  - the `items/items/price_type` response's property type changed from no type to `string` for status `200`
  - the `items/items/status` response's property type changed from no type to `string` for status `200`
  - the `pagination` response's property type changed from no type to `object` for status `200`
  - added the new `ADDON` enum value to the `items/items/price/entity_type` response property for the response status `200`
  - added the new `ADVANCE` enum value to the `items/items/invoice_cadence` response property for the response status `200`
  - added the new `ADVANCE` enum value to the `items/items/price/invoice_cadence` response property for the response status `200`
  - added the new `ARREAR` enum value to the `items/items/invoice_cadence` response property for the response status `200`
  - added the new `ARREAR` enum value to the `items/items/price/invoice_cadence` response property for the response status `200`
  - added the new `BILLING_PERIOD` enum value to the `items/items/price/meter/reset_usage` response property for the response status `200`
  - added the new `COSTSHEET` enum value to the `items/items/price/entity_type` response property for the response status `200`
  - added the new `CUSTOM` enum value to the `items/items/price/price_unit_type` response property for the response status `200`
  - added the new `FIAT` enum value to the `items/items/price/price_unit_type` response property for the response status `200`
  - added the new `FIXED` enum value to the `items/items/price/type` response property for the response status `200`
  - added the new `FIXED` enum value to the `items/items/price_type` response property for the response status `200`
  - added the new `NEVER` enum value to the `items/items/price/meter/reset_usage` response property for the response status `200`
  - added the new `PLAN` enum value to the `items/items/price/entity_type` response property for the response status `200`
  - added the new `PRICE` enum value to the `items/items/price/entity_type` response property for the response status `200`
  - added the new `SUBSCRIPTION` enum value to the `items/items/price/entity_type` response property for the response status `200`
  - …69 more
- **2026-07-09** `4b1a811c4179`: 46 breaking, 48 warning, 35 info
  - the request's body type changed from `object` to no type
  - the `items/items/commitment_time_buckets/items/` response's property type changed from `object` to no type for status `200`
  - the `items/items/created_at` response's property format changed from `date-time` to no format for status `200`
  - the `items/items/end_date` response's property format changed from `date-time` to no format for status `200`
  - the `items/items/entity_type` response's property type changed from `string` to no type for status `200`
  - the `items/items/invoice_cadence` response's property type changed from `string` to no type for status `200`
  - the `items/items/price/created_at` response's property format changed from `date-time` to no format for status `200`
  - the `items/items/price/end_date` response's property format changed from `date-time` to no format for status `200`
  - the `items/items/price/entity_type` response's property type changed from `string` to no type for status `200`
  - the `items/items/price/group/created_at` response's property format changed from `date-time` to no format for status `200`
  - the `items/items/price/group/updated_at` response's property format changed from `date-time` to no format for status `200`
  - the `items/items/price/invoice_cadence` response's property type changed from `string` to no type for status `200`
  - the `items/items/price/metadata` response's property type changed from `object` to no type for status `200`
  - the `items/items/price/meter/aggregation` response's property type changed from `object` to no type for status `200`
  - the `items/items/price/meter/created_at` response's property format changed from `date-time` to no format for status `200`
  - the `items/items/price/meter/filters/items/` response's property type changed from `object` to no type for status `200`
  - the `items/items/price/meter/reset_usage` response's property type changed from `string` to no type for status `200`
  - the `items/items/price/meter/updated_at` response's property format changed from `date-time` to no format for status `200`
  - the `items/items/price/plan/created_at` response's property format changed from `date-time` to no format for status `200`
  - the `items/items/price/plan/credit_grants/items/created_at` response's property format changed from `date-time` to no format for status `200`
  - the `items/items/price/plan/credit_grants/items/credit_grant_anchor` response's property format changed from `date-time` to no format for status `200`
  - the `items/items/price/plan/credit_grants/items/end_date` response's property format changed from `date-time` to no format for status `200`
  - the `items/items/price/plan/credit_grants/items/metadata` response's property type changed from `object` to no type for status `200`
  - the `items/items/price/plan/credit_grants/items/start_date` response's property format changed from `date-time` to no format for status `200`
  - the `items/items/price/plan/credit_grants/items/status` response's property type changed from `string` to no type for status `200`
  - the `items/items/price/plan/credit_grants/items/updated_at` response's property format changed from `date-time` to no format for status `200`
  - the `items/items/price/plan/metadata` response's property type changed from `object` to no type for status `200`
  - the `items/items/price/plan/status` response's property type changed from `string` to no type for status `200`
  - the `items/items/price/plan/updated_at` response's property format changed from `date-time` to no format for status `200`
  - the `items/items/price/price_unit_tiers/items/` response's property type changed from `object` to no type for status `200`
  - the `items/items/price/price_unit_type` response's property type changed from `string` to no type for status `200`
  - the `items/items/price/pricing_unit/created_at` response's property format changed from `date-time` to no format for status `200`
  - the `items/items/price/pricing_unit/metadata` response's property type changed from `object` to no type for status `200`
  - the `items/items/price/pricing_unit/status` response's property type changed from `string` to no type for status `200`
  - the `items/items/price/pricing_unit/updated_at` response's property format changed from `date-time` to no format for status `200`
  - the `items/items/price/start_date` response's property format changed from `date-time` to no format for status `200`
  - the `items/items/price/status` response's property type changed from `string` to no type for status `200`
  - the `items/items/price/tiers/items/` response's property type changed from `object` to no type for status `200`
  - the `items/items/price/transform_quantity` response's property type changed from `object` to no type for status `200`
  - the `items/items/price/type` response's property type changed from `string` to no type for status `200`
  - …89 more
- **2026-06-24** `774ba8074d08`: 1 info
  - added the new optional request property `subscription_line_item_ids`
- **2026-06-16** `257509e66883`: 6 info
  - added the optional property `items/items/commitment_time_buckets/items/commitment_type` to the response with the `200` status
  - added the optional property `items/items/commitment_time_buckets/items/commitment_value` to the response with the `200` status
  - added the optional property `items/items/commitment_time_buckets/items/id` to the response with the `200` status
  - added the optional property `items/items/commitment_time_buckets/items/overage_factor` to the response with the `200` status
  - added the optional property `items/items/commitment_time_buckets/items/price_id` to the response with the `200` status
  - added the optional property `items/items/commitment_time_buckets/items/true_up_enabled` to the response with the `200` status
- **2026-06-10** `2a40f94de722`: 1 info
  - added the optional property `items/items/commitment_time_buckets` to the response with the `200` status
- **2026-06-03** `7adf4f33ea1a`: 1 info
  - added the optional property `items/items/price/sequence` to the response with the `200` status
- **2026-05-18** `8ec2edea6b20`: 4 warning
  - removed the optional property `details` from the response with the `400` status
  - removed the optional property `details` from the response with the `500` status
  - added the new `too_many_requests` enum value to the `code` response property for the response status `400`
  - added the new `too_many_requests` enum value to the `code` response property for the response status `500`
- **2026-05-13** `7934fabd26c1`: 1 info
  - endpoint added

---

[Operation](https://skmtc.dev/flexprice/apis/flexprice-api/docs/subscriptions/lineitems/search/post.md) - [API](https://skmtc.dev/flexprice/apis/flexprice-api.md) - [Page](https://skmtc.dev/flexprice/apis/flexprice-api/changes/subscriptions/lineitems/search/post)
