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
- {protocol}://{site}.{environment}:{port}/api/v2
- {protocol}://{site}-test.{environment}:{port}/api/v2
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:
|
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:
|
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-event-email |
String | No |
skip only emails Possible values:
|
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:
|
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:
|
item_price.trial_period_unit.is |
String | No |
* `day` - A period of 24 hours. * `month` - A period of 1 calendar month. Possible values:
|
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:
|
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:
|
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:
|
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:
|
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:
|
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:
|
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 Possible values:
|
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 Possible values:
|
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:
|
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:
|
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:
|
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
- Add HTTP Task to your workflow definition.
- 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.
- Click Test request to test run your request to the API and see the API's response.