Skip to content

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

License

Notifications You must be signed in to change notification settings

voucherifyio/voucherify-python-sdk

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.7+

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.

📅 Changelog

  • 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 get_campaign GET /v1/campaigns/{campaignId} Get Campaign
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_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 add_member POST /v1/loyalties/{campaignId}/members Add Member
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 Create Points Expiration Export
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_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_earning_rules GET /v1/loyalties/{campaignId}/earning-rules List Earning Rules
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_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 Get Points 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 Add or Remove Loyalty Card Balance
LoyaltiesApi update_loyalty_card_balance1 POST /v1/loyalties/{campaignId}/members/{memberId}/balance Add or Remove 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 Add or Remove 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