Skip to content

voucherifyio/voucherify-python-sdk

BranchesTags

Repository files navigation

Voucherify Python SDK

Official Voucherify SDK for Python

Voucherify empowers marketers and developers with flexible building blocks to come up with, implement, and track targeted promotional campaigns.

Learn more about Voucherify by visiting our site.

This SDK is automatically generated by the OpenAPI Generator based on our Documentation with v2018-08-01 version.

The legacy version of Python SDK could be found here

📝 Documentation

You will find detailed description and example responses at our official documentation. Most method headers point to more detailed descriptions of arguments you can use.

📚 Want to learn more? Visit our official site or our Success Portal.

👽 Having troubles? Check our Help center.

🧪 Looking for promotion ideas? Check our Cookbook to get an inspiration.

🐛 Encounter a bug? Please file a report in the Issues.

✅ Supported endpoint can be found here

Requirements.

Python 3.9+

Installation

To install the API client library to your local Maven repository, simply execute:

pip install 'Voucherify'

Then import the package:

import voucherify

🚀 Running code

Please follow the installation instruction and execute the following Python code:

import os
import voucherify
from dotenv import load_dotenv

load_dotenv()

HOST = os.getenv('VOUCHERIFY_HOST', 'https://api.voucherify.io')
X_APP_ID = os.getenv('X_APP_ID')
X_APP_TOKEN = os.getenv('X_APP_TOKEN')

if not X_APP_ID or not X_APP_TOKEN:
    raise ValueError("X_APP_ID and X_APP_TOKEN must be set in the .env file.")

configuration = voucherify.Configuration(
    host=HOST,
    api_key={
            "X-App-Id": X_APP_ID,
            "X-App-Token": X_APP_TOKEN
        }
)
# Debugging line
api_key_id = configuration.get_api_key_with_prefix('X-App-Id')
api_key_token = configuration.get_api_key_with_prefix('X-App-Token')

# Print whether both API keys are present and valid
are_keys_present = bool(api_key_id) and bool(api_key_token)
print(f"Configuration loaded: {are_keys_present}")

if(are_keys_present):
    with voucherify.ApiClient(configuration) as api_client:
        customers_api_instance = voucherify.CustomersApi(api_client)

        try:
            result = customers_api_instance.list_customers()
            print(result)

        except voucherifyClient.ApiException as e:
            self.fail(e)

It may be useful to check the tests implementation in the folder tests (./__tests__)

🐳 Running local tests with docker

  1. Copy .env.example to .env and fill in the values.
  2. Run docker build -t python . to build the image.
  3. Run docker run --rm python to run the tests and delete container immediately after.

🛠️ Contributing

Read more about how to Contribute to Voucherify Python SDK by visiting main repo GENERATING-SDKS.md

Remember that this SDK is auto generated (except of the tests) so changes made here will be overwritten by generator.

Link tags

OpenAPI generated from tag

📅 Changelog

  • 2025-08-21 - 6.0.0 ADDED: New models:

    • BundleIdentifiedItem model
    • BundleMissingItem model
    • Bundle model
    • CampaignsSummaryGetResponseBody model
    • CampaignsTransactionsExportCreateRequestBody model
    • CampaignsTransactionsExportCreateRequestBodyParameters model
    • CampaignsTransactionsExportCreateResponseBody model
    • CampaignsTransactionsExportCreateResponseBodyParameters model
    • CampaignsTransactionsExportCreateResponseBodyParametersFilters model
    • CampaignsTransactionsExportCreateResponseBodyParametersFiltersCampaignId model
    • CampaignsTransactionsExportCreateResponseBodyParametersFiltersCampaignIdConditions model
    • CampaignsTransactionsExportCreateResponseBodyResult model
    • CampaignsTransactionsListResponseBody model
    • ClientQualificationsCheckEligibilityRequestBodySession model
    • EarningRuleExpirationRules model
    • ExportCampaignTransactionsFilters model
    • LoyaltiesEarningRulesUpdateRequestBodyPendingPoints model
    • LoyaltiesMembersPendingPointsBalanceRequestBody model
    • LoyaltiesMembersPendingPointsBalanceResponseBody model
    • LoyaltiesMembersPendingPointsBalanceResponseBodyRelatedObject model
    • LoyaltiesMembersRedemptionRedeemResponseBodySession model
    • LoyaltiesTransactionsExportCreateRequestBody model
    • LoyaltiesTransactionsExportCreateRequestBodyParameters model
    • LoyaltiesTransactionsListResponseBody model
    • RedemptionEntrySession model
    • RedemptionSession model
    • ParametersFiltersListCampaignTransactions model
    • RedemptionsGetResponseBodySession model
    • RedemptionsListResponseBodyRedemptionsItemSession model
    • VoucherTransactionDetailsHolderLoyaltyTier model
    • ValidationsValidateResponseBodyRedeemablesItemOrderReferrer model
    • ValidationsValidateResponseBodyRedeemablesItemOrderCustomer model
    • ValidationsValidateResponseBodyRedeemablesItemOrder model
    • ValidationsValidateResponseBodyOrderItemsItem model
    • ValidationsValidateResponseBodyOrder model
    • SimpleSku model
    • SimpleReferralTier model
    • SimpleRedemptionRewardResult model
    • SimpleRedemptionChannel model
    • SimpleRedemption model
    • SimplePromotionTierCampaign model
    • SimplePromotionTier model
    • SimplePromotionStackTiers model
    • SimplePromotionStackCampaign model
    • SimplePromotionStack model
    • SimpleProduct model
    • SimpleOrderItem model
    • SimpleOrder model
    • SimpleEvent model
    • SimpleCampaignVoucherRedemption model
    • SimpleCampaignVoucher model
    • SimpleCampaign model
    • RedemptionsRollbacksCreateResponseBodyOrder model
    • RedemptionsRollbackCreateResponseBodyOrder model
    • RedemptionsRedeemResponseBodyOrderItemsItem model
    • RedemptionsRedeemResponseBodyOrder model
    • RedemptionsListResponseBodyRedemptionsItemOrderItemsItemSku model
    • RedemptionsListResponseBodyRedemptionsItemOrderItemsItemProduct model
    • RedemptionsListResponseBodyRedemptionsItemOrderItemsItem model
    • RedemptionsGetResponseBodyOrderItemsItemSku model
    • RedemptionsGetResponseBodyOrderItemsItemProduct model
    • RedemptionsGetResponseBodyOrderItemsItem model
    • RedemptionRollbackOrder model
    • RedemptionOrderReferrer model
    • RedemptionOrderItemsItem model
    • RedemptionOrderCustomer model
    • RedemptionOrder model
    • RedemptionEntryOrderItemsItemSku model
    • RedemptionEntryOrderItemsItemProduct model
    • RedemptionEntryOrderItemsItem model
    • QualificationsRedeemableOrderItemsItem model
    • QualificationsRedeemableOrder model
    • QualificationsRedeemableBaseOrderItemsItem model
    • QualificationsRedeemableBaseOrder model
    • QualificationsCheckEligibilityResponseBodyOrder model
    • ParameterOrderListPendingPoints model
    • ParameterFiltersListMemberTransactions model
    • ParameterFiltersListCampaignsVoucherTypeConditions model
    • ParameterFiltersListCampaignsValidityDayOfWeekConditions model
    • ParameterFiltersListCampaignsValidityDayOfWeek model
    • ParameterFiltersListCampaignsUpdatedAt model
    • ParameterFiltersListCampaignsTypeConditions model
    • ParameterFiltersListCampaignsType model
    • ParameterFiltersListCampaignsStatusConditions model
    • ParameterFiltersListCampaignsStatus model
    • ParameterFiltersListCampaignsStartDate model
    • ParameterFiltersListCampaignsIsReferralCodeConditions model
    • ParameterFiltersListCampaignsExpirationDate model
    • ParameterFiltersListCampaignsCreatedDate model
    • ParameterFiltersListCampaignsCampaignsId model
    • ParameterFiltersListCampaignsCampaigns model
    • ParameterFiltersListCampaignsActive model
    • ParameterCustomerEvent model
    • ParameterCampaignsAccessSetttingsFilter model
    • ParameterCampaignsAccessSetttings model
    • ParameterCampaignStatusListCampaigns model
    • OrdersListResponseBodyOrdersItem model
    • MemberActivityDataTransactionDetailsSourceVoucherRedemption model
    • MemberActivityDataTransactionDetailsSourceVoucherLoyaltyCard model
    • MemberActivityDataTransactionDetailsSourceVoucherGift model
    • MemberActivityDataTransactionDetailsSourceVoucher model
    • MemberActivityDataTransactionDetailsSegment model
    • MemberActivityDataTransactionDetailsRollback model
    • MemberActivityDataTransactionDetailsReward model
    • MemberActivityDataTransactionDetailsRedemption model
    • MemberActivityDataTransactionDetailsOrder model
    • MemberActivityDataTransactionDetailsLoyaltyTier model
    • MemberActivityDataTransactionDetailsHolderLoyaltyTier model
    • MemberActivityDataTransactionDetailsEventSchema model
    • MemberActivityDataTransactionDetailsEvent model
    • MemberActivityDataTransactionDetailsEarningRuleSource model
    • MemberActivityDataTransactionDetailsEarningRule model
    • MemberActivityDataTransactionDetailsDestinationVoucherRedemption model
    • MemberActivityDataTransactionDetailsDestinationVoucherLoyaltyCard model
    • MemberActivityDataTransactionDetailsDestinationVoucherGift model
    • MemberActivityDataTransactionDetailsDestinationVoucher model
    • MemberActivityDataTransactionDetailsCustomEvent model
    • MemberActivityDataTransactionDetails model
    • MemberActivityDataTransaction model
    • MemberActivityDataRedemptionVoucherRedemption model
    • MemberActivityDataRedemptionVoucherPublish model
    • MemberActivityDataRedemptionVoucherLoyaltyCard model
    • MemberActivityDataRedemptionVoucherGift model
    • MemberActivityDataRedemptionVoucher model
    • MemberActivityDataRedemptionRewardVoucherRedemption model
    • MemberActivityDataRedemptionRewardVoucherPublish model
    • MemberActivityDataRedemptionRewardVoucherLoyaltyCard model
    • MemberActivityDataRedemptionRewardVoucherGift model
    • MemberActivityDataRedemptionRewardVoucher model
    • MemberActivityDataRedemptionRewardSku model
    • MemberActivityDataRedemptionRewardProduct model
    • MemberActivityDataRedemptionRewardParametersProduct model
    • MemberActivityDataRedemptionRewardParametersCoin model
    • MemberActivityDataRedemptionRewardParametersCampaign model
    • MemberActivityDataRedemptionRewardParameters model
    • MemberActivityDataRedemptionRewardCustomer model
    • MemberActivityDataRedemptionReward model
    • MemberActivityDataRedemptionRelatedRedemptionsRollbacksItem model
    • MemberActivityDataRedemptionRelatedRedemptionsRedemptionsItem model
    • MemberActivityDataRedemptionRelatedRedemptions model
    • MemberActivityDataRedemptionPromotionTierSummaryRedemptions model
    • MemberActivityDataRedemptionPromotionTierSummaryOrders model
    • MemberActivityDataRedemptionPromotionTierSummary model
    • MemberActivityDataRedemptionPromotionTierCampaign model
    • MemberActivityDataRedemptionPromotionTierAction model
    • MemberActivityDataRedemptionPromotionTier model
    • MemberActivityDataRedemptionPreviousOrderReferrer model
    • MemberActivityDataRedemptionPreviousOrderCustomer model
    • MemberActivityDataRedemptionPreviousOrder model
    • MemberActivityDataRedemptionOrderReferrer model
    • MemberActivityDataRedemptionOrderItemsItemSku model
    • MemberActivityDataRedemptionOrderItemsItemProduct model
    • MemberActivityDataRedemptionOrderItemsItem model
    • MemberActivityDataRedemptionOrderCustomer model
    • MemberActivityDataRedemptionOrder model
    • MemberActivityDataRedemptionChannel model
    • MemberActivityDataRedemption model
    • MemberActivityDataOrderReferrer model
    • MemberActivityDataOrderItemsItemSku model
    • MemberActivityDataOrderItemsItemProduct model
    • MemberActivityDataOrderItemsItem model
    • MemberActivityDataOrderCustomer model
    • MemberActivityDataOrder model
    • MemberActivityDataCustomerEvent model
    • MemberActivityDataBalanceRelatedObject model
    • MemberActivityDataBalance model
    • MemberActivityData1 model
    • MemberActivityData model
    • LoyaltyPendingPointsDetailsOrder model
    • LoyaltyPendingPointsDetailsLoyaltyTier model
    • LoyaltyPendingPointsDetailsHolderLoyaltyTier model
    • LoyaltyPendingPointsDetailsEvent model
    • LoyaltyPendingPointsDetailsEarningRuleSource model
    • LoyaltyPendingPointsDetailsEarningRule model
    • LoyaltyPendingPointsDetails model
    • LoyaltyPendingPoints model
    • LoyaltyCardTransactionDetailsHolderLoyaltyTier model
    • LoyaltiesPendingPointsListResponseBody model
    • LoyaltiesMembersRedemptionRedeemResponseBodyOrderReferrer model
    • LoyaltiesMembersRedemptionRedeemResponseBodyOrderItemsItem model
    • LoyaltiesMembersRedemptionRedeemResponseBodyOrderCustomer model
    • LoyaltiesMembersRedemptionRedeemResponseBodyOrder model
    • LoyaltiesMembersPendingPointsListResponseBody model
    • LoyaltiesMembersPendingPointsBalanceResponseBody model
    • LoyaltiesMembersPendingPointsBalanceRequestBody model
    • LoyaltiesMembersPendingPointsActivateResponseBodyRelatedObject model
    • LoyaltiesMembersPendingPointsActivateResponseBody model
    • LoyaltiesEarningRulesUpdateResponseBodyPendingPoints model
    • LoyaltiesEarningRulesGetResponseBodyPendingPoints model
    • LoyaltiesEarningRulesEnableResponseBodyPendingPoints model
    • LoyaltiesEarningRulesDisableResponseBodyPendingPoints model
    • LoyaltiesEarningRulesCreateResponseBodyPendingPoints model
    • LoyaltiesEarningRulesCreateRequestBodyItemPendingPoints model
    • LoyaltiesCampaignPendingPointsListResponseBody model
    • ListPublicationsItemValidSingleVoucherMetadata model
    • ListPublicationsItemValidSingleVoucher model
    • InapplicableToOrderItemUnitsItem model
    • ApplicableToOrderItemUnitsItem model
    • EventSourceUser model
    • EventSourceApiKey model
    • EventSource model
    • EarningRulePendingPoints model
    • CustomEventReferral model
    • CustomEventLoyalty model
    • CustomEvent model
    • ClientValidationsValidateResponseBodyRedeemablesItemOrderReferrer model
    • ClientValidationsValidateResponseBodyRedeemablesItemOrderCustomer model
    • ClientValidationsValidateResponseBodyRedeemablesItemOrder model
    • ClientValidationsValidateResponseBodyOrderItemsItem model
    • ClientValidationsValidateResponseBodyOrder model
    • ClientRedemptionsRedeemResponseBodyOrderItemsItem model
    • ClientRedemptionsRedeemResponseBodyOrder model
    • ClientQualificationsCheckEligibilityResponseBodyOrderItemsItem model
    • ClientQualificationsCheckEligibilityResponseBodyOrder model
    • ApplicationDetailsItem model

    New properties:

    • holder_loyalty_tier, pending_points properties in VoucherTransactionDetails
    • has_more property in AsyncActionsListResponseBody model
    • fixed_month, fixed_day properties in CampaignLoyaltyCardExpirationRules model
    • subtracted_amount property in CampaignsVouchersCreateCombinedResponseBodyGift model
    • pending_points, expired_points, subtracted_points properties in CampaignsVouchersCreateCombinedResponseBodyLoyaltyCard model
    • subtracted_amount property in CampaignsVouchersCreateResponseBodyGift model
    • expired_points, subtracted_points properties in CampaignsVouchersCreateResponseBodyLoyaltyCard model
    • session property in ClientQualificationsCheckEligibilityRequestBody model
    • id property in ClientValidationsValidateResponseBody model
    • bundle property in ClientValidationsValidateResponseBodyRedeemablesItemResult model
    • balance property in ClientValidationsValidateResponseBodyRedeemablesItemResultGift model
    • pending_points,expiration_rules properties in EarningRule model
    • subtracted_amount property in Gift model
    • pending_points, expiration_rules properties in LoyaltiesEarningRulesCreateRequestBodyItem model
    • pending_points, expiration_rules properties in LoyaltiesEarningRulesCreateResponseBody model
    • pending_points, expiration_rules properties in LoyaltiesEarningRulesDisableResponseBody model
    • pending_points, expiration_rules properties in LoyaltiesEarningRulesEnableResponseBody model
    • pending_points, expiration_rules properties in LoyaltiesEarningRulesGetResponseBody model
    • pending_points, expiration_rules properties in LoyaltiesEarningRulesUpdateRequestBody model
    • expiration_rules,pending_points properties in LoyaltiesEarningRulesUpdateResponseBody model
    • session property in LoyaltiesMembersRedemptionRedeemResponseBody model
    • rollback_order_mode property in LoyaltiesMembersRedemptionRedeemResponseBodyRelatedRedemptionsRollbacksItem model
    • subtracted_amount property in LoyaltiesMembersRedemptionRedeemResponseBodyVoucherGift model
    • redeemables_products_application_mode, redeemables_no_effect_rule, no_effect_skip_categories, no_effect_redeem_anyway_categories, redeemables_rollback_order_mode properties in ManagementProjectsStackingRules, ManagementProjectsStackingRulesCreateRequestBody, ManagementProjectsStackingRulesCreateResponseBody, ManagementProjectsStackingRulesGetResponseBody, ManagementProjectsStackingRulesUpdateRequestBody, ManagementProjectsStackingRulesUpdateResponseBody models
    • session property in QualificationsCheckEligibilityRequestBody model
    • locked_credits property in RedeemableGift model
    • bundle property in RedeemableResult model
    • expired_points, subtracted_points properties in LoyaltiesMembersCreateResponseBodyLoyaltyCard model
    • expired_points, subtracted_points properties in LoyaltiesMembersGetResponseBodyLoyaltyCard model
    • expired_points, subtracted_points properties in LoyaltiesMembersRedemptionRedeemResponseBodyVoucherLoyaltyCard model
    • expired_points, subtracted_points properties in LoyaltiesMembersTransfersCreateResponseBodyLoyaltyCard model
    • expired_points, subtracted_points properties in LoyaltyMemberLoyaltyCard model
    • expired_points, subtracted_points properties in RedeemableVoucherLoyaltyCard model
    • expired_points, subtracted_points properties in RedemptionsListResponseBodyRedemptionsItemVoucherLoyaltyCard model
    • expired_points, subtracted_points properties in SimpleLoyaltyCard model
    • expired_points, subtracted_points properties in RedemptionsGetResponseBodyVoucherLoyaltyCard model
    • expired_points, subtracted_points properties in RedemptionEntryVoucherLoyaltyCard model
    • expired_points, subtracted_points properties in RedemptionVoucherLoyaltyCard model
    • expired_points, subtracted_points properties in VoucherLoyaltyCard model
    • expired_points, subtracted_points properties in VoucherWithCategoriesLoyaltyCard model
    • expired_points, subtracted_points properties in VouchersCreateResponseBodyLoyaltyCard model
    • expired_points, subtracted_points properties in VouchersDisableResponseBodyLoyaltyCard model
    • expired_points, subtracted_points properties in VouchersEnableResponseBodyLoyaltyCard model
    • expired_points, subtracted_points properties in VouchersGetResponseBodyLoyaltyCard model
    • expired_points, subtracted_points properties in VouchersUpdateResponseBodyLoyaltyCard model
    • session property in Redemption model
    • session property in RedemptionEntry model
    • session property in RedemptionsGetResponseBody model
    • rollback_order_mode property in RedemptionEntryRelatedRedemptionsRollbacksItem model
    • rollback_order_mode property in RedemptionRelatedRedemptionsRollbacksItem model
    • rollback_order_mode property in RedemptionsGetResponseBodyRelatedRedemptionsRollbacksItem model
    • rollback_order_mode property in RedemptionsListResponseBodyRedemptionsItemRelatedRedemptionsRollbacksItem model
    • redeemed_points property in SimpleVoucherRedemption model
    • no_effect_skip_categories, no_effect_redeem_anyway_categories, redeemables_rollback_order_mode properties in StackingRules model
    • bundle_rules in ValidationRule, ValidationRulesCreateRequestBody, ValidationRulesCreateResponseBody, ValidationRulesGetResponseBody, ValidationRulesUpdateRequestBody, ValidationRulesUpdateResponseBody models
    • bundle property in ValidationsRedeemableInapplicableResult, ValidationsValidateResponseBodyRedeemablesItemResult models
    • id property in ValidationsValidateResponseBody model
    • balance property in ValidationsValidateResponseBodyRedeemablesItemResultGift model
    • subtracted_amount property in RedeemableVoucherGift model
    • subtracted_amount property in VoucherGift model
    • subtracted_amount property in VoucherWithCategoriesGift model
    • subtracted_amount property in RedemptionEntryVoucherGift model
    • subtracted_amount in VouchersCreateResponseBodyGift model
    • subtracted_amount property in RedemptionVoucherGift model
    • subtracted_amount property in VouchersDisableResponseBodyGift model
    • subtracted_amount property in VouchersEnableResponseBodyGift model
    • subtracted_amount property in VouchersGetResponseBodyGift model
    • subtracted_amount property in VouchersUpdateResponseBodyGift model
    • subtracted_amount property in RedemptionsGetResponseBodyVoucherGift model
    • subtracted_amount property in RedemptionsListResponseBodyRedemptionsItemVoucherGift model
    • items property in RedemptionsListResponseBodyRedemptionsItemOrder model
    • session property in RedemptionsListResponseBodyRedemptionsItem model
    • items property in RedemptionsGetResponseBodyOrder model
    • campaigns, campaigns_id, status, active, type, created_date, updated_at, start_date, expiration_date, validity_day_of_week properties in ParameterFiltersListCampaigns model
    • holder_loyalty_tier, pending_points properties in LoyaltyCardTransactionDetails model
    • access_settings property in LoyaltiesUpdateCampaignRequestBody model
    • access_settings property in LoyaltiesCreateCampaignRequestBody model
    • order_item_units property in InapplicableTo model
    • contains, not_contain properties in FilterConditionsString model
    • access_settings property in CampaignsUpdateRequestBody model
    • access_settings property in CampaignsCreateRequestBody model
    • access_settings_assignments property in CampaignsGetResponseBody model
    • access_settings_assignments property in CampaignBase model
    • access_settings_assignments property in Campaign model
    • all_stores property in AreaStoreCampaignAssignment model
    • order_item_units property in ApplicableTo model
    • area_all_stores_ids property in AccessSettingsUnassign model
    • area_all_stores_ids property in AccessSettingsAssign model UPDATED:
    • period_type enum in CampaignLoyaltyCardExpirationRules model
    • The allowed values for the list items in the events property of ManagementProjectsWebhook, ManagementProjectsWebhooksCreateRequestBody, ManagementProjectsWebhooksCreateResponseBody, ManagementProjectsWebhooksGetResponseBody, ManagementProjectsWebhooksUpdateRequestBody, ManagementProjectsWebhooksUpdateResponseBody models were updated to include new campaign and voucher-related events.
    • Enum validation updated in initial_sync_status field in SegmentsCreateResponseBody, SegmentsGetResponseBody models: passive was added as a valid value.
    • New enum values in VoucherTransaction model
    • order property in RedemptionsListResponseBodyRedemptionsItemOrder model updated from List[OrderCalculatedItem] (items) and OrderCalculated (order) to List[RedemptionsListResponseBodyRedemptionsItemOrderItemsItem] (items).
    • customer property in RedemptionsListResponseBodyRedemptionsItemOrder model updated from Optional[SimpleCustomer] to Optional[RedemptionsListResponseBodyRedemptionsItemOrderCustomer].
    • type property in ProductCollectionsCreateRequestBody model: Previously Optional[StrictStr] with default 'STATIC' and only allowed value 'STATIC'. Now Optional[StrictStr] with no default and enum values expanded to 'STATIC' and 'AUTO_UPDATE'. Now Optional[StrictStr] with no default and enum values expanded to 'STATIC' and 'AUTO_UPDATE'
    • New value PENDING_POINTS_ACTIVATION in LoyaltyCardTransactionsType enum
    • balance now uses VoucherBalance instead of LoyaltyCardTransactionDetailsBalance in LoyaltyCardTransactionDetails.
    • Added alias="$more_than" and alias="$less_than" to the more_than and less_than properties in the FilterConditionsDateTime model. !!! BREAKING CHANGES !!!:
    • Aliases for more_than and less_than fields were changed to $more_than and $less_than. The alias change means that when the object is serialized to or deserialized from JSON, the keys for these fields have changed (more_than → $more_than, less_than → $less_than). This may require updating existing code or requests that use the previous field names.
    • applicable_exclusive_redeemables_per_category_limit property in ManagementProjectsStackingRules model now has a range validation (1–30) and uses Annotated[int] instead of StrictInt.
    • applicable_redeemables_per_category_limit, applicable_exclusive_redeemables_per_category_limit properties in ManagementProjectsStackingRulesCreateRequestBody, ManagementProjectsStackingRulesCreateResponseBody, ManagementProjectsStackingRulesGetResponseBody, ManagementProjectsStackingRulesUpdateRequestBody, ManagementProjectsStackingRulesUpdateResponseBody models changed from StrictInt to Annotated[int, Field(le=30, strict=True, ge=1)] with range validation (1–30)
    • applicable_redeemables_limit property in ManagementProjectsStackingRulesCreateRequestBody, ManagementProjectsStackingRulesCreateResponseBody, ManagementProjectsStackingRulesGetResponseBody, ManagementProjectsStackingRulesUpdateRequestBody, ManagementProjectsStackingRulesUpdateResponseBody models now has le=30
    • balance property in VoucherTransactionDetails model updated from VoucherTransactionDetailsBalance to VoucherBalance.
    • order property in ValidationsValidateResponseBodyRedeemablesItem model updated from OrderCalculated to ValidationsValidateResponseBodyRedeemablesItemOrder.
    • order property in ValidationsValidateResponseBody model updated from OrderCalculated to ValidationsValidateResponseBodyOrder.
    • order property in RedemptionsRollbacksCreateResponseBody model updated from OrderCalculated to RedemptionsRollbacksCreateResponseBodyOrder.
    • order property in RedemptionsRollbackCreateResponseBody model updated from OrderCalculated to RedemptionsRollbackCreateResponseBodyOrder.
    • related_redemptions property removed from RedemptionsRollbackCreateResponseBody model.
    • order property in RedemptionsRedeemResponseBody model updated from OrderCalculated to RedemptionsRedeemResponseBodyOrder.
    • related_redemptions property removed from RedemptionRollback model.
    • order property in RedemptionRollback model updated from OrderCalculated to RedemptionRollbackOrder.
    • items property in RedemptionRollback model updated from List[OrderCalculatedItem] to List[RedemptionEntryOrderItemsItem].
    • order property in Redemption model updated from OrderCalculated to RedemptionOrder.
    • order property in Redemption model updated from QualificationsRedeemable to QualificationsRedeemableOrder.
    • limit property in QualificationsOption models now has le=50
    • order property in QualificationsCheckEligibilityResponseBody model updated from OrderCalculated to QualificationsCheckEligibilityResponseBodyOrder.
    • conditions property in ParameterFiltersListCustomerRedeemablesVoucherType model updated from ParameterFiltersListCustomerRedeemablesVoucherTypeConditions to ParameterFiltersListCampaignsVoucherTypeConditions.
    • conditions property in ParameterFiltersListCampaignsVoucherType model updated from ParameterFiltersListCampaignsVoucherType to ParameterFiltersListCampaignsVoucherType.
    • ParameterFiltersListCampaignsIsReferralCode model: Removed $is and $is_not properties. Added conditions property of type ParameterFiltersListCampaignsIsReferralCodeConditions. JSON serialization/deserialization keys changed from "$is" / "$is_not" to "conditions". Enum validation for 'TRUE' / 'FALSE' no longer applies; validation is now handled by the conditions object.
    • order property in OrdersListResponseBodyOrdersItem model updated from OrderCalculated to OrdersListResponseBodyOrdersItem.
    • items property removed from OrderCalculated model
    • data property type changed from Dict[str, Any] to a structured MemberActivityData1 model in MemberActivity model.
    • Added enum validation on the type property with a predefined set of allowed event types in MemberActivity model.
    • Field expires_at type changed from Optional[datetime] → Optional[date] in LoyaltyPointsBucket model.
    • data property in LoyaltiesMembersPointsExpirationListResponseBody model updated from List[LoyaltiesMembersPointsExpirationListResponseBodyDataItem] to List[LoyaltyPointsBucket].
    • validation_rules property was removed from LoyaltiesCreateCampaignRequestBody model
    • strict property was removed from InapplicableTo model
    • type property in CustomerActivity model now has enum validation. A field_validator was added to enforce that the type value must be one of the allowed predefined event types. Previously, any string value was accepted.
    • order property in ClientValidationsValidateResponseBodyRedeemablesItem model updated from OrderCalculated to ClientValidationsValidateResponseBodyRedeemablesItem.
    • order property in ClientValidationsValidateResponseBody model updated from OrderCalculated to ClientValidationsValidateResponseBodyOrder.
    • order property in ClientRedemptionsRedeemResponseBody model updated from OrderCalculated to ClientRedemptionsRedeemResponseBodyOrder.
    • Added enum validation for operation_status property in AsyncActionGetResponseBody, AsyncActionBase models. A new field_validator was introduced to ensure that operation_status only accepts the values: 'FAILED', 'SUCCESS', or 'UNKNOWN'.
    • Added enum validation for target property in ApplicableTo model. A new field_validator was introduced to ensure that target only accepts the values: 'FAILED', 'ITEM', or 'UNIT'.
    • application_details property was removed from OrderCalculatedItem model

TESTS:

  • Updated test suites: test_01_validation.py, test_02_redemption.py, test_05_products.py,
  • Created new test suites: test_06_campaigns.py, test_07_client.py, test_09_orders.py, test_08_vouchers.py, test_10_customer.py, test_11_management.py DOCS:
  • Updated .env.example file to include placeholder for Management Api keys
  • Updated README.md:
    • Introduced separate configurations for Application API and Management API.
    • Added debugging checks to confirm whether both Application and Management API keys are loaded correctly.
    • Extended example code:
      • Application API: lists sample customers.
      • Management API: lists available projects.
    • Improved documentation for running local tests.
  • 2024-01-29 - 5.0.3
    • Added support for GET /v1/loyalties/{campaignId}/pending-points
    • Added support for GET /v1/loyalties/members/{memberId}/pending-points
    • Added support for GET /v1/loyalties/{campaignId}/members/{memberId}/pending-points
    • Added support for POST /v1/loyalties/members/{memberId}/pending-points/{pendingPointsId}/activate
    • Added support for POST /v1/loyalties/members/{memberId}/pending-points/{pendingPointsId}/cancel
    • Added types for pending points (loyalties) and access settings (areas and stores)
  • 2024-11-26 - 5.0.2
    • Added support for STANDALONE campaign type.
    • Added optional metadata in OrderCalculatedItemSku
    • New possible value of ParameterExpandListCampaigns
    • New optional error parameter in Error
    • Updated LoyaltyCardTransactionDetailsBalance
  • 2024-11-04 - 5.0.1
    • Added support for returning campaign_id and campaign_name in stackable validation endpoint, when redeemable option is expanded
  • 2024-10-28 - 5.0.0
    • Added missing enums in few filters models
    • !!! BREAKING CHANGES !!!
      • VouchersApi.generateRandomCode now requires VouchersCreateResponseBody instead of plain object
      • property product in model Discount now uses DiscountProduct instead of SimpleProductDiscountUnit
      • property filters of model ExportsCreateRequestBodyParameters now uses plain object instead of ExportsCreateRequestBodyParametersFilters
  • 2024-10-25 - 4.0.0
    • Fix object parsing in query. For example filters while listing redemptions.
    • !!! BREAKING CHANGES !!!
      • Remove support for /client/v1/customers/{customerId}/consents - put Update Customer's consents (client-side) [Deprecated]
      • Pagination changed on listing card transactions(listLoyaltyCardTransactions) - NO page param is supported - use starting_after_id instead.
      • Pagination changed on listing voucher transactions(listVoucherTransactions) - NO page param is supported - use starting_after_id instead.
      • ApplicableToEffect - changed - EVERY -> TO_EVERY, CHEAPEST -> TO_CHEAPEST, MOST_EXPENSIVE -> TO_MOST_EXPENSIVE, 2 new values introduced.
      • listPublications parameter filters have changed - now uses ParameterFiltersListPublications instead of String
      • ParameterFiltersListRedemptions and ParameterFiltersListCustomerRedeemables have been updated
      • enum LUCKY_DRAW, LUCKY_DRAW_CODE, VOUCHER_LUCKY_DRAW_CODE, CAMPAIGN_LUCKY_DRAW have been deleted from everywhere and no longer supported
      • CampaignsUpdateRequestBody - properties activityDurationAfterPublishing, joinOnce, autoJoin, type, uniqueWinners, uniqueWinnersPerDraw and enum AUTO_UPDATE | STATIC have been deleted and no longer supported
      • updateCustomersConsents has been deleted and no longer supported
      • FilterConditionsDateTimeConditions model has been renamed to FilterConditionsDateTime
      • FilterConditionsDateTime - conditions has been divided on $after, $before, $hasValue, $isUnknown, moreThan, lessThan properties
      • ParamterFiltersListCustomerRedeemables - model name of createdAt has been renamed from FilterConditionsDateTime to ParameterFiltersListCustomerRedeemablesCreatedAt
      • filter property in schemas ProductCollectionsCreateRequestBody, ProductCollectionsCreateResponseBody, ProductCollectionsItem and ProductCollectionsGetResponseBody has changed. Uses plain object.
      • discount property in schema CampaignsUpdateRequestBody now uses Discount model
      • properties winnersCount, uniqueWinnersPerDraw, uniqueWinners in model CampaignsUpdateRequestBody were deleted.
      • property stackingRulesType were deleted from models CategoriesGetResponseBody, Category
      • property categories in model ClientValidationsValidateResponseBodyRedeemablesItem uses now Array model
      • model ParameterFiltersListCustomerRedeemablesCampaignId has been fixed, can use junction properly.
      • model ParameterFiltersListRedemptions has been fixed, can use junction properly.
      • property filter in model ProductCollectionsCreateRequestBody now uses plain Object
      • property categories in model QualificationsRedeemable now uses Array<CategoryWithStackingRulesType>
    • Added support:
      • /v1/metadata-schemas - get List Metadata Schemas
      • /v1/metadata-schemas/{resource} - get Get Metadata Schema
      • /v1/locations - List Locations
      • /v1/locations/{locationId} - get Get Location
      • /v1/referrals/{campaignId}/members/{memberId}/holders - post Add Referral Code Holders
      • /v1/referrals/{campaignId}/members/{memberId}/holders - get List Referral Code Holders
      • /v1/referrals/{campaignId}/members/{memberId}/holders/{holderId} - delete Remove Referral Card Holder
      • /v1/referrals/members/{memberId}/holders - post Add Referral Code Holders
      • /v1/referrals/members/{memberId}/holders - get List Referral Code Holders
      • /v1/referrals/members/{memberId}/holders/{holderId} - delete Remove Referral Card Holder
      • /v1/trash-bin - get List Bin Entries
      • /v1/trash-bin/{binEntryId} - delete Delete Bin Entry
      • /v1/templates/campaigns - get List Campaign Templates
      • /v1/templates/campaigns - post Create Campaign Template
      • /v1/templates/campaigns/{campaignTemplateId} - get Get Campaign Template
      • /v1/templates/campaigns/{campaignTemplateId} - put Update Campaign Template
      • /v1/templates/campaigns/{campaignTemplateId} - delete Delete Campaign Template
      • /v1/templates/campaigns/{campaignTemplateId}/campaign-setup - post Create Campaign From Template
      • /v1/templates/campaigns/{campaignTemplateId}/tier-setup - post Add Promotion Tier From Template
      • /management/v1/projects - post Create Project
      • /management/v1/projects - get List Projects
      • /management/v1/projects/{projectId} - get Get Project
      • /management/v1/projects/{projectId} - put Update Project
      • /management/v1/projects/{projectId} - delete Delete Project
      • /management/v1/projects/{projectId}/users - post Assign User
      • /management/v1/projects/{projectId}/users/{userId} - put Update User
      • /management/v1/projects/{projectId}/users/{userId} - delete Unassign User
      • /management/v1/projects/users/invite - post Invite a New User
      • /management/v1/projects/{projectId}/templates/campaigns - get List Campaign Templates
      • /management/v1/projects/{projectId}/templates/campaigns/{campaignTemplateId}/copy - post Copy Campaign Template to a Project
      • /management/v1/projects/{projectId}/stacking-rules - post Create Stacking Rules
      • /management/v1/projects/{projectId}/stacking-rules - get List Stacking Rules
      • /management/v1/projects/{projectId}/stacking-rules/{stackingRulesId} - get Get Stacking Rules
      • /management/v1/projects/{projectId}/stacking-rules/{stackingRulesId} - put Update Stacking Rules
      • /management/v1/projects/{projectId}/stacking-rules/{stackingRulesId} - delete Delete Stacking Rules
      • /management/v1/projects/{projectId}/metadata-schemas - post Create Metadata Schema
      • /management/v1/projects/{projectId}/metadata-schemas - get List Metadata Schemas
      • /management/v1/projects/{projectId}/metadata-schemas/{metadataSchemaId} - get Get Metadata Schema
      • /management/v1/projects/{projectId}/metadata-schemas/{metadataSchemaId} - put Update Metadata Schema
      • /management/v1/projects/{projectId}/metadata-schemas/{metadataSchemaId} - delete Delete Metadata Schema
      • /management/v1/projects/{projectId}/custom-event-schemas - post Create Custom Event Schema
      • /management/v1/projects/{projectId}/custom-event-schemas - get List Custom Event Schemas
      • /management/v1/projects/{projectId}/custom-event-schemas/{customEventSchemaId} - get Get Custom Event Schema
      • /management/v1/projects/{projectId}/custom-event-schemas/{customEventSchemaId} - put Update Custom Event Schema
      • /management/v1/projects/{projectId}/custom-event-schemas/{customEventSchemaId} - delete Delete Custom Event Schema
      • /management/v1/projects/{projectId}/webhooks - post Create Webhook
      • /management/v1/projects/{projectId}/webhooks - get List Webhooks
      • /management/v1/projects/{projectId}/webhooks/{webhookId} - get Get Webhook
      • /management/v1/projects/{projectId}/webhooks/{webhookId} - put Update Webhook
      • /management/v1/projects/{projectId}/webhooks/{webhookId} - delete Delete Webhook
      • /management/v1/projects/{projectId}/branding - post Create Brand
      • /management/v1/projects/{projectId}/branding - get List Brands
      • /management/v1/projects/{projectId}/branding/{brandingId} - get Get Brand
      • /management/v1/projects/{projectId}/branding/{brandingId} - put Update Brand
      • /management/v1/projects/{projectId}/branding/{brandingId} - delete Delete Brand
  • 2024-09-18 - 3.0.0
    • The new version of the SDK includes coverage for all the most commonly used Voucherify endpoints and supports typed models.

Previous versions of the API are no longer supported, and we highly recommend upgrading to version 3.0.0, which is now designated as Long-Term Support (LTS).

Changelog for previous versions could be found in here

🔐 Documentation for Authorization

import os
import voucherify
from dotenv import load_dotenv

load_dotenv()

HOST = os.getenv('VOUCHERIFY_HOST', 'https://api.voucherify.io')
X_APP_ID = os.getenv('X_APP_ID')
X_APP_TOKEN = os.getenv('X_APP_TOKEN')

if not X_APP_ID or not X_APP_TOKEN:
    raise ValueError("X_APP_ID and X_APP_TOKEN must be set in the .env file.")

configuration = voucherify.Configuration(
    host=HOST,
    api_key={
            "X-App-Id": X_APP_ID,
            "X-App-Token": X_APP_TOKEN
        }
)
# Debugging line
api_key_id = configuration.get_api_key_with_prefix('X-App-Id')
api_key_token = configuration.get_api_key_with_prefix('X-App-Token')

# Print whether both API keys are present and valid
are_keys_present = bool(api_key_id) and bool(api_key_token)
print(f"Configuration loaded: {are_keys_present}")

then use

import voucherify

(...)
    with voucherify.ApiClient(configuration) as api_client:

Documentation for API Endpoints

All URIs are relative to https://api.voucherify.io

Class Method HTTP request Description
AsyncActionsApi get_async_action GET /v1/async-actions/{asyncActionId} Get Async Action
AsyncActionsApi list_async_actions GET /v1/async-actions List Async Actions
BinApi delete_bin_entry DELETE /v1/trash-bin/{binEntryId} Delete Bin Entry
BinApi list_bin_entries GET /v1/trash-bin List Bin Entries
CampaignsApi add_voucher_with_specific_code_to_campaign POST /v1/campaigns/{campaignId}/vouchers/{code} Add Voucher with Specific Code to Campaign
CampaignsApi add_vouchers_to_campaign POST /v1/campaigns/{campaignId}/vouchers Add Vouchers to Campaign
CampaignsApi create_campaign POST /v1/campaigns Create Campaign
CampaignsApi delete_campaign DELETE /v1/campaigns/{campaignId} Delete Campaign
CampaignsApi disable_campaign POST /v1/campaigns/{campaignId}/disable Disable Campaign
CampaignsApi enable_campaign POST /v1/campaigns/{campaignId}/enable Enable Campaign
CampaignsApi export_campaign_transactions POST /v1/campaigns/{campaignId}/transactions/export Export Campaign Transactions
CampaignsApi get_campaign GET /v1/campaigns/{campaignId} Get Campaign
CampaignsApi get_campaign_summary GET /v1/campaigns/{campaignId}/summary Get Campaign Summary
CampaignsApi import_vouchers_to_campaign POST /v1/campaigns/{campaignId}/import Import Vouchers to Campaign
CampaignsApi import_vouchers_to_campaign_using_csv POST /v1/campaigns/{campaignId}/importCSV Import Vouchers to Campaign by CSV
CampaignsApi list_campaign_transactions GET /v1/campaigns/{campaignId}/transactions List Campaign Transactions
CampaignsApi list_campaigns GET /v1/campaigns List Campaigns
CampaignsApi update_campaign PUT /v1/campaigns/{campaignId} Update Campaign
CategoriesApi create_category POST /v1/categories Create Category
CategoriesApi delete_category DELETE /v1/categories/{categoryId} Delete Category
CategoriesApi get_category GET /v1/categories/{categoryId} Get Category
CategoriesApi list_categories GET /v1/categories List Categories
CategoriesApi update_category PUT /v1/categories/{categoryId} Update Category
ClientSideApi check_eligibility_client_side POST /client/v1/qualifications Check Eligibility (client-side)
ClientSideApi list_promotion_tiers_client_side GET /client/v1/promotions/tiers List Promotion Tiers (client-side)
ClientSideApi redeem_stacked_discounts_client_side POST /client/v1/redemptions Redeem Stackable Discounts (client-side)
ClientSideApi track_custom_event_client_side POST /client/v1/events Track Custom Event (client-side)
ClientSideApi validate_stacked_discounts_client_side POST /client/v1/validations Validate Stackable Discounts (client-side)
CustomersApi create_customer POST /v1/customers Create Customer
CustomersApi customer_permanently_deletion POST /v1/customers/{customerId}/permanent-deletion Delete Customer Permanently
CustomersApi delete_customer DELETE /v1/customers/{customerId} Delete Customer
CustomersApi get_customer GET /v1/customers/{customerId} Get Customer
CustomersApi import_customers_using_csv POST /v1/customers/importCSV Import and Update Customers using CSV
CustomersApi list_customer_activity GET /v1/customers/{customerId}/activity List Customer Activity
CustomersApi list_customer_redeemables GET /v1/customers/{customerId}/redeemables List Customer's Redeemables
CustomersApi list_customer_segments GET /v1/customers/{customerId}/segments List Customer's Segments
CustomersApi list_customers GET /v1/customers List Customers
CustomersApi update_customer PUT /v1/customers/{customerId} Update Customer
CustomersApi update_customers_in_bulk POST /v1/customers/bulk/async Update Customers in Bulk
CustomersApi update_customers_metadata_in_bulk POST /v1/customers/metadata/async Update Customers' Metadata in Bulk
EventsApi track_custom_event POST /v1/events Track Custom Event
ExportsApi create_export POST /v1/exports Create Export
ExportsApi delete_export DELETE /v1/exports/{exportId} Delete Export
ExportsApi download_export GET /v1/exports/{export_Id} Download Export
ExportsApi get_export GET /v1/exports/{exportId} Get Export
ExportsApi list_exports GET /v1/exports List Exports
LocationsApi get_location GET /v1/locations/{locationId} Get Location
LocationsApi list_locations GET /v1/locations List Locations
LoyaltiesApi activate_member_pending_points POST /v1/loyalties/members/{memberId}/pending-points/{pendingPointsId}/activate Activate Member Pending Points
LoyaltiesApi add_member POST /v1/loyalties/{campaignId}/members Add Member
LoyaltiesApi adjust_member_pending_points POST /v1/loyalties/members/{memberId}/pending-points/{pendingPointsId}/balance Adjust Member Pending Points
LoyaltiesApi cancel_member_pending_points POST /v1/loyalties/members/{memberId}/pending-points/{pendingPointsId}/cancel Cancel Member Pending Points
LoyaltiesApi create_earning_rule POST /v1/loyalties/{campaignId}/earning-rules Create Earning Rule
LoyaltiesApi create_in_bulk_loyalty_tiers POST /v1/loyalties/{campaignId}/tiers Create loyalty tiers
LoyaltiesApi create_loyalty_program POST /v1/loyalties Create Loyalty Campaign
LoyaltiesApi create_points_expiration_export POST /v1/loyalties/{campaignId}/points-expiration/export Export Loyalty Campaign Point Expiration
LoyaltiesApi create_reward_assignment1 POST /v1/loyalties/{campaignId}/rewards Create Reward Assignment
LoyaltiesApi delete_earning_rule DELETE /v1/loyalties/{campaignId}/earning-rules/{earningRuleId} Delete Earning Rule
LoyaltiesApi delete_loyalty_program DELETE /v1/loyalties/{campaignId} Delete Loyalty Campaign
LoyaltiesApi delete_reward_assignment1 DELETE /v1/loyalties/{campaignId}/rewards/{assignmentId} Delete Reward Assignment
LoyaltiesApi disable_earning_rule POST /v1/loyalties/{campaignId}/earning-rules/{earningRuleId}/disable Disable Earning Rule
LoyaltiesApi enable_earning_rule POST /v1/loyalties/{campaignId}/earning-rules/{earningRuleId}/enable Enable Earning Rule
LoyaltiesApi export_loyalty_campaign_transactions POST /v1/loyalties/{campaignId}/transactions/export Export Loyalty Campaign Transactions
LoyaltiesApi export_loyalty_card_transactions POST /v1/loyalties/members/{memberId}/transactions/export Export Loyalty Card Transactions
LoyaltiesApi export_loyalty_card_transactions1 POST /v1/loyalties/{campaignId}/members/{memberId}/transactions/export Export Loyalty Card Transactions
LoyaltiesApi get_earning_rule GET /v1/loyalties/{campaignId}/earning-rules/{earningRuleId} Get Earning Rule
LoyaltiesApi get_loyalty_program GET /v1/loyalties/{campaignId} Get Loyalty Campaign
LoyaltiesApi get_loyalty_tier GET /v1/loyalties/{campaignId}/tiers/{loyaltyTierId} Get Loyalty Tier
LoyaltiesApi get_member GET /v1/loyalties/members/{memberId} Get Member
LoyaltiesApi get_member1 GET /v1/loyalties/{campaignId}/members/{memberId} Get Member
LoyaltiesApi get_reward_assignment1 GET /v1/loyalties/{campaignId}/reward-assignments/{assignmentId} Get Reward Assignment
LoyaltiesApi get_reward_assignment2 GET /v1/loyalties/{campaignId}/rewards/{assignmentId} Get Reward Assignment
LoyaltiesApi get_reward_details GET /v1/loyalties/{campaignId}/reward-assignments/{assignmentId}/reward Get Reward Details
LoyaltiesApi list_campaign_pending_points GET /v1/loyalties/{campaignId}/pending-points List Campaign Pending Points
LoyaltiesApi list_earning_rules GET /v1/loyalties/{campaignId}/earning-rules List Earning Rules
LoyaltiesApi list_loyalty_campaign_transactions GET /v1/loyalties/{campaignId}/transactions List Loyalty Campaign Transactions
LoyaltiesApi list_loyalty_card_transactions GET /v1/loyalties/members/{memberId}/transactions List Loyalty Card Transactions
LoyaltiesApi list_loyalty_card_transactions1 GET /v1/loyalties/{campaignId}/members/{memberId}/transactions List Loyalty Card Transactions
LoyaltiesApi list_loyalty_programs GET /v1/loyalties List Loyalty Campaigns
LoyaltiesApi list_loyalty_tier_earning_rules GET /v1/loyalties/{campaignId}/tiers/{loyaltyTierId}/earning-rules List Loyalty Tier Earning Rules
LoyaltiesApi list_loyalty_tier_rewards GET /v1/loyalties/{campaignId}/tiers/{loyaltyTierId}/rewards List Loyalty Tier Rewards
LoyaltiesApi list_loyalty_tiers GET /v1/loyalties/{campaignId}/tiers List Loyalty Tiers
LoyaltiesApi list_member_activity GET /v1/loyalties/members/{memberId}/activity List Member Activity
LoyaltiesApi list_member_activity1 GET /v1/loyalties/{campaignId}/members/{memberId}/activity List Member Activity
LoyaltiesApi list_member_loyalty_tier GET /v1/loyalties/members/{memberId}/tiers List Member's Loyalty Tiers
LoyaltiesApi list_member_pending_points GET /v1/loyalties/members/{memberId}/pending-points List Member Pending Points
LoyaltiesApi list_member_pending_points1 GET /v1/loyalties/{campaignId}/members/{memberId}/pending-points List Member Pending Points
LoyaltiesApi list_member_rewards GET /v1/loyalties/members/{memberId}/rewards List Member Rewards
LoyaltiesApi list_members GET /v1/loyalties/{campaignId}/members List Members
LoyaltiesApi list_points_expiration GET /v1/loyalties/{campaignId}/members/{memberId}/points-expiration List Loyalty Card Point Expiration
LoyaltiesApi list_reward_assignments1 GET /v1/loyalties/{campaignId}/reward-assignments List Reward Assignments
LoyaltiesApi list_reward_assignments2 GET /v1/loyalties/{campaignId}/rewards List Reward Assignments
LoyaltiesApi redeem_reward POST /v1/loyalties/members/{memberId}/redemption Redeem Reward
LoyaltiesApi redeem_reward1 POST /v1/loyalties/{campaignId}/members/{memberId}/redemption Redeem Reward
LoyaltiesApi transfer_points POST /v1/loyalties/{campaignId}/members/{memberId}/transfers Transfer Loyalty Points
LoyaltiesApi update_earning_rule PUT /v1/loyalties/{campaignId}/earning-rules/{earningRuleId} Update Earning Rule
LoyaltiesApi update_loyalty_card_balance POST /v1/loyalties/members/{memberId}/balance Adjust Loyalty Card Balance
LoyaltiesApi update_loyalty_card_balance1 POST /v1/loyalties/{campaignId}/members/{memberId}/balance Adjust Loyalty Card Balance
LoyaltiesApi update_loyalty_program PUT /v1/loyalties/{campaignId} Update Loyalty Campaign
LoyaltiesApi update_reward_assignment1 PUT /v1/loyalties/{campaignId}/rewards/{assignmentId} Update Reward Assignment
ManagementApi assign_user POST /management/v1/projects/{projectId}/users Assign User
ManagementApi create_brand POST /management/v1/projects/{projectId}/branding Create Brand
ManagementApi create_custom_event_schema POST /management/v1/projects/{projectId}/custom-event-schemas Create Custom Event Schema
ManagementApi create_metadata_schema POST /management/v1/projects/{projectId}/metadata-schemas Create Metadata Schema
ManagementApi create_project POST /management/v1/projects Create Project
ManagementApi create_stacking_rules POST /management/v1/projects/{projectId}/stacking-rules Create Stacking Rules
ManagementApi create_webhook POST /management/v1/projects/{projectId}/webhooks Create Webhook
ManagementApi delete_brand DELETE /management/v1/projects/{projectId}/branding/{brandingId} Delete Brand
ManagementApi delete_custom_event_schema DELETE /management/v1/projects/{projectId}/custom-event-schemas/{customEventSchemaId} Delete Custom Event Schema
ManagementApi delete_metadata_schema DELETE /management/v1/projects/{projectId}/metadata-schemas/{metadataSchemaId} Delete Metadata Schema
ManagementApi delete_project DELETE /management/v1/projects/{projectId} Delete Project
ManagementApi delete_stacking_rules DELETE /management/v1/projects/{projectId}/stacking-rules/{stackingRulesId} Delete Stacking Rules
ManagementApi delete_webhook DELETE /management/v1/projects/{projectId}/webhooks/{webhookId} Delete Webhook
ManagementApi get_brand GET /management/v1/projects/{projectId}/branding/{brandingId} Get Brand
ManagementApi get_custom_event_schema GET /management/v1/projects/{projectId}/custom-event-schemas/{customEventSchemaId} Get Custom Event Schema
ManagementApi get_metadata_schema1 GET /management/v1/projects/{projectId}/metadata-schemas/{metadataSchemaId} Get Metadata Schema
ManagementApi get_project GET /management/v1/projects/{projectId} Get Project
ManagementApi get_stacking_rules GET /management/v1/projects/{projectId}/stacking-rules/{stackingRulesId} Get Stacking Rules
ManagementApi get_user GET /management/v1/projects/{projectId}/users/{userId} Get User
ManagementApi get_webhook GET /management/v1/projects/{projectId}/webhooks/{webhookId} Get Webhook
ManagementApi invite_user POST /management/v1/projects/users/invite Invite a New User
ManagementApi list_brands GET /management/v1/projects/{projectId}/branding List Brands
ManagementApi list_custom_event_schemas GET /management/v1/projects/{projectId}/custom-event-schemas List Custom Event Schemas
ManagementApi list_metadata_schemas1 GET /management/v1/projects/{projectId}/metadata-schemas List Metadata Schemas
ManagementApi list_projects GET /management/v1/projects List Projects
ManagementApi list_stacking_rules GET /management/v1/projects/{projectId}/stacking-rules List Stacking Rules
ManagementApi list_users GET /management/v1/projects/{projectId}/users List Users
ManagementApi list_webhooks GET /management/v1/projects/{projectId}/webhooks List Webhooks
ManagementApi management_copy_campaign_template POST /management/v1/projects/{projectId}/templates/campaigns/{campaignTemplateId}/copy Copy Campaign Template to a Project
ManagementApi management_list_campaign_templates GET /management/v1/projects/{projectId}/templates/campaigns List Campaign Templates
ManagementApi unassign_user DELETE /management/v1/projects/{projectId}/users/{userId} Unassign User
ManagementApi update_brand PUT /management/v1/projects/{projectId}/branding/{brandingId} Update Brand
ManagementApi update_custom_event_schema PUT /management/v1/projects/{projectId}/custom-event-schemas/{customEventSchemaId} Update Custom Event Schema
ManagementApi update_metadata_schema PUT /management/v1/projects/{projectId}/metadata-schemas/{metadataSchemaId} Update Metadata Schema
ManagementApi update_project PUT /management/v1/projects/{projectId} Update Project
ManagementApi update_stacking_rules PUT /management/v1/projects/{projectId}/stacking-rules/{stackingRulesId} Update Stacking Rules
ManagementApi update_user PUT /management/v1/projects/{projectId}/users/{userId} Update User
ManagementApi update_webhook PUT /management/v1/projects/{projectId}/webhooks/{webhookId} Update Webhook
MetadataSchemasApi get_metadata_schema GET /v1/metadata-schemas/{resource} Get Metadata Schema
MetadataSchemasApi list_metadata_schemas GET /v1/metadata-schemas List Metadata Schemas
OrdersApi create_order POST /v1/orders Create Order
OrdersApi create_order_export POST /v1/orders/export Create Orders Export
OrdersApi get_order GET /v1/orders/{orderId} Get Order
OrdersApi import_orders POST /v1/orders/import Import Orders
OrdersApi list_orders GET /v1/orders List Orders
OrdersApi update_order PUT /v1/orders/{orderId} Update Order
ProductCollectionsApi create_product_collection POST /v1/product-collections Create Product Collection
ProductCollectionsApi delete_product_collection DELETE /v1/product-collections/{productCollectionId} Delete Product Collection
ProductCollectionsApi get_product_collection GET /v1/product-collections/{productCollectionId} Get Product Collection
ProductCollectionsApi list_product_collections GET /v1/product-collections List Product Collections
ProductCollectionsApi list_products_in_collection GET /v1/product-collections/{productCollectionId}/products List Products in Collection
ProductsApi create_product POST /v1/products Create Product
ProductsApi create_sku POST /v1/products/{productId}/skus Create SKU
ProductsApi delete_product DELETE /v1/products/{productId} Delete Product
ProductsApi delete_sku DELETE /v1/products/{productId}/skus/{skuId} Delete SKU
ProductsApi get_product GET /v1/products/{productId} Get Product
ProductsApi get_sku GET /v1/skus/{skuId} Get SKU
ProductsApi import_products_using_csv POST /v1/products/importCSV Import Products using CSV
ProductsApi import_skus_using_csv POST /v1/skus/importCSV Import SKUs using CSV
ProductsApi list_products GET /v1/products List Products
ProductsApi list_skus_in_product GET /v1/products/{productId}/skus List SKUs in Product
ProductsApi update_product PUT /v1/products/{productId} Update Product
ProductsApi update_products_in_bulk POST /v1/products/bulk/async Update Products in Bulk
ProductsApi update_products_metadata_in_bulk POST /v1/products/metadata/async Update Products' Metadata in Bulk
ProductsApi update_sku PUT /v1/products/{productId}/skus/{skuId} Update SKU
PromotionsApi add_promotion_tier_to_campaign POST /v1/promotions/{campaignId}/tiers Add Promotion Tier to Campaign
PromotionsApi create_promotion_stack POST /v1/promotions/{campaignId}/stacks Create Promotion Stack
PromotionsApi delete_promotion_stack DELETE /v1/promotions/{campaignId}/stacks/{stackId} Delete Promotion Stack
PromotionsApi delete_promotion_tier DELETE /v1/promotions/tiers/{promotionTierId} Delete Promotion Tier
PromotionsApi disable_promotion_tier POST /v1/promotions/tiers/{promotionTierId}/disable Disable Promotion Tier
PromotionsApi enable_promotion_tier POST /v1/promotions/tiers/{promotionTierId}/enable Enable Promotion Tier
PromotionsApi get_promotion_stack GET /v1/promotions/{campaignId}/stacks/{stackId} Get Promotion Stack
PromotionsApi get_promotion_tier GET /v1/promotions/tiers/{promotionTierId} Get Promotion Tier
PromotionsApi list_all_promotion_stacks GET /v1/promotions/stacks List Promotion Stacks
PromotionsApi list_promotion_stacks_in_campaign GET /v1/promotions/{campaignId}/stacks List Promotion Stacks in Campaign
PromotionsApi list_promotion_tiers GET /v1/promotions/tiers List Promotion Tiers
PromotionsApi list_promotion_tiers_from_campaign GET /v1/promotions/{campaignId}/tiers List Promotion Tiers from Campaign
PromotionsApi update_promotion_stack PUT /v1/promotions/{campaignId}/stacks/{stackId} Update Promotion Stack
PromotionsApi update_promotion_tier PUT /v1/promotions/tiers/{promotionTierId} Update Promotion Tier
PublicationsApi create_publication POST /v1/publications Create Publication
PublicationsApi create_publication1 GET /v1/publications/create Create Publication
PublicationsApi list_publications GET /v1/publications List Publications
QualificationsApi check_eligibility POST /v1/qualifications Check Eligibility
RedemptionsApi get_redemption GET /v1/redemptions/{redemptionId} Get Redemption
RedemptionsApi get_voucher_redemptions GET /v1/vouchers/{code}/redemption Get Voucher's Redemptions
RedemptionsApi list_redemptions GET /v1/redemptions List Redemptions
RedemptionsApi redeem_stacked_discounts POST /v1/redemptions Redeem Stackable Discounts
RedemptionsApi rollback_redemption POST /v1/redemptions/{redemptionId}/rollback Rollback Redemption
RedemptionsApi rollback_stacked_redemptions POST /v1/redemptions/{parentRedemptionId}/rollbacks Rollback Stackable Redemptions
ReferralsApi referrals_add_holders POST /v1/referrals/members/{memberId}/holders Add Referral Code Holders
ReferralsApi referrals_add_holders1 POST /v1/referrals/{campaignId}/members/{memberId}/holders Add Referral Code Holders
ReferralsApi referrals_code_holders GET /v1/referrals/{campaignId}/members/{memberId}/holders List Referral Code Holders
ReferralsApi referrals_code_holders1 GET /v1/referrals/members/{memberId}/holders List Referral Code Holders
ReferralsApi referrals_remove_holder DELETE /v1/referrals/members/{memberId}/holders/{holderId} Remove Referral Card Holder
ReferralsApi referrals_remove_holder1 DELETE /v1/referrals/{campaignId}/members/{memberId}/holders/{holderId} Remove Referral Card Holder
RewardsApi create_reward POST /v1/rewards Create Reward
RewardsApi create_reward_assignment POST /v1/rewards/{rewardId}/assignments Create Reward Assignment
RewardsApi delete_reward DELETE /v1/rewards/{rewardId} Delete Reward
RewardsApi delete_reward_assignment DELETE /v1/rewards/{rewardId}/assignments/{assignmentId} Delete Reward Assignment
RewardsApi get_reward GET /v1/rewards/{rewardId} Get Reward
RewardsApi get_reward_assignment GET /v1/rewards/{rewardId}/assignments/{assignmentId} Get Reward Assignment
RewardsApi list_reward_assignments GET /v1/rewards/{rewardId}/assignments List Reward Assignments
RewardsApi list_rewards GET /v1/rewards List Rewards
RewardsApi update_reward PUT /v1/rewards/{rewardId} Update Reward
RewardsApi update_reward_assignment PUT /v1/rewards/{rewardId}/assignments/{assignmentId} Update Reward Assignment
SegmentsApi create_segment POST /v1/segments Create Segment
SegmentsApi delete_segment DELETE /v1/segments/{segmentId} Delete Segment
SegmentsApi get_segment GET /v1/segments/{segmentId} Get Segment
TemplatesApi add_tier_from_template POST /v1/templates/campaigns/{campaignTemplateId}/tier-setup Add Promotion Tier From Template
TemplatesApi create_campaign_from_template POST /v1/templates/campaigns/{campaignTemplateId}/campaign-setup Create Campaign From Template
TemplatesApi create_campaign_template POST /v1/templates/campaigns Create Campaign Template
TemplatesApi delete_campaign_template DELETE /v1/templates/campaigns/{campaignTemplateId} Delete Campaign Template
TemplatesApi get_campaign_template GET /v1/templates/campaigns/{campaignTemplateId} Get Campaign Template
TemplatesApi list_campaign_templates GET /v1/templates/campaigns List Campaign Templates
TemplatesApi update_campaign_template PUT /v1/templates/campaigns/{campaignTemplateId} Update Campaign Template
ValidationRulesApi create_validation_rule_assignment POST /v1/validation-rules/{validationRuleId}/assignments Create Validation Rules Assignments
ValidationRulesApi create_validation_rules POST /v1/validation-rules Create Validation Rules
ValidationRulesApi delete_validation_rule_assignment DELETE /v1/validation-rules/{validationRuleId}/assignments/{assignmentId} Delete Validation Rule Assignment
ValidationRulesApi delete_validation_rules DELETE /v1/validation-rules/{validationRuleId} Delete Validation Rule
ValidationRulesApi get_validation_rule GET /v1/validation-rules/{validationRuleId} Get Validation Rule
ValidationRulesApi list_validation_rule_assignments GET /v1/validation-rules/{validationRuleId}/assignments List Validation Rule Assignments
ValidationRulesApi list_validation_rules GET /v1/validation-rules List Validation Rules
ValidationRulesApi list_validation_rules_assignments GET /v1/validation-rules-assignments List Validation Rules' Assignment(s)
ValidationRulesApi update_validation_rule PUT /v1/validation-rules/{validationRuleId} Update Validation Rule
ValidationsApi validate_stacked_discounts POST /v1/validations Validate Stackable Discounts
VouchersApi create_voucher POST /v1/vouchers/{code} Create Voucher
VouchersApi delete_voucher DELETE /v1/vouchers/{code} Delete Voucher
VouchersApi disable_voucher POST /v1/vouchers/{code}/disable Disable Voucher
VouchersApi enable_voucher POST /v1/vouchers/{code}/enable Enable Voucher
VouchersApi export_voucher_transactions POST /v1/vouchers/{code}/transactions/export Export Voucher Transactions
VouchersApi generate_random_code POST /v1/vouchers Generate Random Code
VouchersApi get_voucher GET /v1/vouchers/{code} Get Voucher
VouchersApi import_vouchers POST /v1/vouchers/import Import Vouchers
VouchersApi import_vouchers_using_csv POST /v1/vouchers/importCSV Import Vouchers using CSV
VouchersApi list_voucher_transactions GET /v1/vouchers/{code}/transactions List Voucher Transactions
VouchersApi list_vouchers GET /v1/vouchers List Vouchers
VouchersApi release_validation_session DELETE /v1/vouchers/{code}/sessions/{sessionKey} Release Validation Session
VouchersApi update_voucher PUT /v1/vouchers/{code} Update Voucher
VouchersApi update_voucher_balance POST /v1/vouchers/{code}/balance Adjust Voucher Balance
VouchersApi update_vouchers_in_bulk POST /v1/vouchers/bulk/async Update Vouchers in Bulk
VouchersApi update_vouchers_metadata_in_bulk POST /v1/vouchers/metadata/async Update Vouchers' Metadata in Bulk

Documentation For Models

Documentation For Authorization

Authentication schemes defined for the API:

X-App-Id

  • Type: API key
  • API key parameter name: X-App-Id
  • Location: HTTP header

X-App-Token

  • Type: API key
  • API key parameter name: X-App-Token
  • Location: HTTP header

X-Client-Token

  • Type: API key
  • API key parameter name: X-Client-Token
  • Location: HTTP header

X-Client-Application-Id

  • Type: API key
  • API key parameter name: X-Client-Application-Id
  • Location: HTTP header

X-Management-Id

  • Type: API key
  • API key parameter name: X-Management-Id
  • Location: HTTP header

X-Management-Token

  • Type: API key
  • API key parameter name: X-Management-Token
  • Location: HTTP header

Author

support@voucherify.io

About

Voucherify Python SDK | Use cases: online coupons, prepaid vouchers, in-app promo codes

www.voucherify.io

Topics

python sdk voucher

Resources

Readme

License

MIT license
Activity
Custom properties

Stars

13 stars

Watchers

6 watching

Forks

12 forks
Report repository

Releases 8

v6.0.0 Latest
Oct 9, 2025
+ 7 releases

Packages

No packages published

Contributors 12

Languages