POST /exports/item_prices

This API triggers export of item price data. The exported zip file contains CSV files with item price-related data.

Servers

Request headers

Name Type Required Description
chargebee-request-origin-device String No

The device from which the customer has made the request

Content-Type String Yes The media type of the request body.

Default value: "application/x-www-form-urlencoded"

chargebee-event-webhook String No

skip only webhooks

Possible values:

  • "all-disabled"
chargebee-business-entity-id String No

If the site has multiple business entities, you can use this custom HTTP header to specify the business entity for which Chargebee should perform the operation.

chargebee-event-actions String No

skip all actions to be done on the events

Possible values:

  • "all-disabled"
chargebee-request-origin-user String No

The email address of your customer/user. Use this when the email address has only ASCII characters.

chargebee-request-origin-ip String No

The IP address of the customer where the request originated

chargebee-request-origin-user-encoded String No

The Base64-encoded email address of your customer/user. Use this if the email address has UTF-8 characters. When this header is provided, the header chargebee-request-origin-user is ignored.

chargebee-event-email String No

skip only emails

Possible values:

  • "all-disabled"

Request body fields

Name Type Required Description
currency_code Object No

optional, string filter Filter item prices based on their `currency_code`. **Supported operators :** is, is_not, starts_with, in, not_in **Example →** *currency_code\[is\] = "USD"*

currency_code.not_in String No
currency_code.starts_with String No
currency_code.in String No
currency_code.is_not String No
currency_code.is String No
business_entity_id Object No

optional, string filter The unique ID of the [business entity](/docs/api/business_entities) of this `item_price`. [Learn more](using_business_entity_filters_in_product_catalog_list_apis) about all the scenarios before using this filter. **Supported operators :** is, is_present **Example →** *business_entity_id\[is_present\] = "true"*

business_entity_id.is String No
business_entity_id.is_present String No

null

Possible values:

  • "false"
  • "true"
item_price Object No

Parameters for item_price

item_price.id Object No

Filter item prices based on their [id](#).

item_price.id.not_in String No
item_price.id.starts_with String No
item_price.id.in String No
item_price.id.is_not String No
item_price.id.is String No
item_price.trial_period_unit Object No

Filter item prices based on their `trial_period_unit`.

item_price.trial_period_unit.not_in String No
item_price.trial_period_unit.in String No
item_price.trial_period_unit.is_not String No

* `day` - A period of 24 hours. * `month` - A period of 1 calendar month.

Possible values:

  • "month"
  • "day"
item_price.trial_period_unit.is String No

* `day` - A period of 24 hours. * `month` - A period of 1 calendar month.

Possible values:

  • "month"
  • "day"
item_price.period_unit Object No

Filter item prices based on their `period_unit`.

item_price.period_unit.not_in String No
item_price.period_unit.in String No
item_price.period_unit.is_not String No

* `day` - A period of 24 hours. * `week` - A period of 7 days. * `month` - A period of 1 calendar month. * `year` - A period of 1 calendar year.

Possible values:

  • "month"
  • "day"
  • "week"
  • "year"
item_price.period_unit.is String No

* `day` - A period of 24 hours. * `week` - A period of 7 days. * `month` - A period of 1 calendar month. * `year` - A period of 1 calendar year.

Possible values:

  • "month"
  • "day"
  • "week"
  • "year"
item_price.pricing_model Object No

Filter item prices based on their `pricing_model`.

item_price.pricing_model.not_in String No
item_price.pricing_model.in String No
item_price.pricing_model.is_not String No

* `flat_fee` - A fixed price that is not quantity-based. * `per_unit` - A fixed price per unit quantity. * `tiered` - The per unit price is based on the tier that the total quantity falls in. * `volume` - There are quantity tiers for which per unit prices are set. Quantities are purchased from successive tiers. * `stairstep` - A quantity-based pricing scheme. The item is charged a fixed price based on the tier that the total quantity falls in.

Possible values:

  • "tiered"
  • "per_unit"
  • "stairstep"
  • "flat_fee"
  • "volume"
item_price.pricing_model.is String No

* `flat_fee` - A fixed price that is not quantity-based. * `per_unit` - A fixed price per unit quantity. * `tiered` - The per unit price is based on the tier that the total quantity falls in. * `volume` - There are quantity tiers for which per unit prices are set. Quantities are purchased from successive tiers. * `stairstep` - A quantity-based pricing scheme. The item is charged a fixed price based on the tier that the total quantity falls in.

Possible values:

  • "tiered"
  • "per_unit"
  • "stairstep"
  • "flat_fee"
  • "volume"
item_price.name Object No

Filter item prices based on their `name`s.

item_price.name.not_in String No
item_price.name.starts_with String No
item_price.name.in String No
item_price.name.is_not String No
item_price.name.is String No
item_price.channel Object No

The subscription channel this object originated from and is maintained in.

item_price.channel.not_in String No
item_price.channel.in String No
item_price.channel.is_not String No

* `web` - The object was created (and is maintained) for the web channel directly in Chargebee via API or UI. * `app_store` - The object data is synchronized with data from in-app subscription(s) created in Apple App Store. Direct manipulation of this object via UI or API is disallowed. * `play_store` - The object data is synchronized with data from in-app subscription(s) created in Google Play Store. Direct manipulation of this object via UI or API is disallowed.

In-App Subscriptions is currently in early access. Contact eap@chargebee.com for more information.

Possible values:

  • "web"
  • "play_store"
  • "app_store"
item_price.channel.is String No

* `web` - The object was created (and is maintained) for the web channel directly in Chargebee via API or UI. * `app_store` - The object data is synchronized with data from in-app subscription(s) created in Apple App Store. Direct manipulation of this object via UI or API is disallowed. * `play_store` - The object data is synchronized with data from in-app subscription(s) created in Google Play Store. Direct manipulation of this object via UI or API is disallowed.

In-App Subscriptions is currently in early access. Contact eap@chargebee.com for more information.

Possible values:

  • "web"
  • "play_store"
  • "app_store"
item_price.price_variant_id Object No

Filter item prices based on their [price_variant_id](price_variants#price_variant_id).

item_price.price_variant_id.not_in String No
item_price.price_variant_id.starts_with String No
item_price.price_variant_id.in String No
item_price.price_variant_id.is_not String No
item_price.price_variant_id.is String No
item_price.period Object No

Filter item prices based on their `period`.

item_price.period.gt String No
item_price.period.lte String No
item_price.period.between String No
item_price.period.gte String No
item_price.period.is_not String No
item_price.period.lt String No
item_price.period.is String No
item_price.trial_period Object No

Filter item prices based on their `trial_period`.

item_price.trial_period.gt String No
item_price.trial_period.lte String No
item_price.trial_period.between String No
item_price.trial_period.gte String No
item_price.trial_period.is_not String No
item_price.trial_period.lt String No
item_price.trial_period.is String No
item_price.status Object No

Filter item prices based on their `status`.

item_price.status.not_in String No
item_price.status.in String No
item_price.status.is_not String No

* `active` - The item price can be used in subscriptions. * `archived` - The item price is no longer active and cannot be used in new subscriptions or added to existing ones. Existing subscriptions that already have this item price will continue to renew with the item price. * `deleted` - Indicates that the item price has been deleted. The id and name can be reused.

Possible values:

  • "active"
  • "deleted"
  • "archived"
item_price.status.is String No

* `active` - The item price can be used in subscriptions. * `archived` - The item price is no longer active and cannot be used in new subscriptions or added to existing ones. Existing subscriptions that already have this item price will continue to renew with the item price. * `deleted` - Indicates that the item price has been deleted. The id and name can be reused.

Possible values:

  • "active"
  • "deleted"
  • "archived"
item_price.item_id Object No

Filter item prices based on their `item_id`.

item_price.item_id.not_in String No
item_price.item_id.starts_with String No
item_price.item_id.in String No
item_price.item_id.is_not String No
item_price.item_id.is String No
item_price.updated_at Object No

Filter item prices based on their `updated_at`.

item_price.updated_at.on String No
item_price.updated_at.after String No
item_price.updated_at.between String No
item_price.updated_at.before String No
include_site_level_resources Object No

optional, boolean filter Default value is `true` . To exclude site-level resources in [specific cases](), set this parameter to `false`. Possible values are : *true, false* **Supported operators :** is **Example →** *include_site_level_resources\[is\] = "null"*

include_site_level_resources.is String No

Possible values:

  • "false"
  • "true"
item_type Object No

optional, enumerated string filter Filter item prices based on `item_type`. Possible values are : plan, addon, charge. **Supported operators :** is, is_not, in, not_in **Example →** *item_type\[is_not\] = "plan"*

item_type.not_in String No
item_type.in String No
item_type.is_not String No

* `plan` - An essential component of a subscription. Every subscription has exactly one plan. It has a recurring charge and its period defines the billing period of the subscription. * `addon` - A recurring component that can be added to a subscription in addition to its plan. * `charge` - A non-recurring component that can be added to a subscription in addition to its plan. An charge can also be applied to a customer directly without being applied to a subscription.

Possible values:

  • "plan"
  • "charge"
  • "addon"
item_type.is String No

* `plan` - An essential component of a subscription. Every subscription has exactly one plan. It has a recurring charge and its period defines the billing period of the subscription. * `addon` - A recurring component that can be added to a subscription in addition to its plan. * `charge` - A non-recurring component that can be added to a subscription in addition to its plan. An charge can also be applied to a customer directly without being applied to a subscription.

Possible values:

  • "plan"
  • "charge"
  • "addon"
item_family_id Object No

optional, string filter Filter item prices based on `item_family_id`. **Supported operators :** is, is_not, starts_with, in, not_in **Example →** *item_family_id\[is\] = "Acme"*

item_family_id.not_in String No
item_family_id.starts_with String No
item_family_id.in String No
item_family_id.is_not String No
item_family_id.is String No

How to start integrating

  1. Add HTTP Task to your workflow definition.
  2. Search for the API you want to integrate with and click on the name.
    • This loads the API reference documentation and prepares the Http request settings.
  3. Click Test request to test run your request to the API and see the API's response.