Find Subscription
Finds a subscription by its reference.
Authorization
BasicAuth The username is a Maxio Chargify API key. The password is x.
In: header
Query Parameters
Subscription reference
Response Body
application/json
curl -X GET "https://example.com/subscriptions/lookup.json"{ "subscription": { "id": 0, "state": "pending", "balance_in_cents": 0, "total_revenue_in_cents": 0, "product_price_in_cents": 0, "product_version_number": 0, "current_period_ends_at": "2019-08-24T14:15:22Z", "next_assessment_at": "2019-08-24T14:15:22Z", "trial_started_at": "2019-08-24T14:15:22Z", "trial_ended_at": "2019-08-24T14:15:22Z", "activated_at": "2019-08-24T14:15:22Z", "expires_at": "2019-08-24T14:15:22Z", "created_at": "2019-08-24T14:15:22Z", "updated_at": "2019-08-24T14:15:22Z", "cancellation_message": "string", "cancellation_method": "merchant_ui", "cancel_at_end_of_period": true, "canceled_at": "2019-08-24T14:15:22Z", "current_period_started_at": "2019-08-24T14:15:22Z", "previous_state": "pending", "signup_payment_id": 0, "signup_revenue": "string", "delayed_cancel_at": "2019-08-24T14:15:22Z", "coupon_code": "string", "snap_day": "string", "payment_collection_method": "automatic", "customer": { "first_name": "string", "last_name": "string", "email": "string", "cc_emails": "string", "organization": "string", "reference": "string", "id": 0, "created_at": "2019-08-24T14:15:22Z", "updated_at": "2019-08-24T14:15:22Z", "address": "string", "address_2": "string", "city": "string", "state": "string", "state_name": "string", "zip": "string", "country": "string", "country_name": "string", "phone": "string", "verified": true, "portal_customer_created_at": "2019-08-24T14:15:22Z", "portal_invite_last_sent_at": "2019-08-24T14:15:22Z", "portal_invite_last_accepted_at": "2019-08-24T14:15:22Z", "tax_exempt": true, "surcharging": true, "vat_number": "string", "vat_country": "string", "entity_identifier_kind": "vat_eu", "entity_identifier_value": "string", "parent_id": 0, "locale": "string", "default_subscription_group_uid": "string", "salesforce_id": "string", "tax_exempt_reason": "string", "default_auto_renewal_profile_id": 0, "maxioid": "string", "branding_theme_id": 0 }, "product": { "id": 0, "name": "string", "handle": "string", "description": "string", "accounting_code": "string", "request_credit_card": true, "expiration_interval": 0, "expiration_interval_unit": "day", "created_at": "2019-08-24T14:15:22Z", "updated_at": "2019-08-24T14:15:22Z", "price_in_cents": 0, "interval": 0, "interval_unit": "day", "initial_charge_in_cents": 0, "trial_price_in_cents": 0, "trial_interval": 0, "trial_interval_unit": "day", "archived_at": "2019-08-24T14:15:22Z", "require_credit_card": true, "return_params": "string", "taxable": true, "update_return_url": "string", "initial_charge_after_trial": true, "version_number": 0, "update_return_params": "string", "product_family": { "id": 0, "name": "string", "handle": "string", "accounting_code": null, "description": "string", "surcharging": true, "created_at": "2019-08-24T14:15:22Z", "updated_at": "2019-08-24T14:15:22Z", "archived_at": "2019-08-24T14:15:22Z" }, "public_signup_pages": [ { "id": 0, "return_url": "string", "return_params": "string", "url": "string" } ], "product_price_point_name": "string", "request_billing_address": true, "require_billing_address": true, "require_shipping_address": true, "tax_code": "string", "default_product_price_point_id": 0, "use_site_exchange_rate": true, "item_category": "string", "product_price_point_id": 0, "product_price_point_handle": "string", "unspsc_code": "string", "features": [ { "id": 0, "feature_template_id": 0, "feature_key": "string", "feature_name": "string", "feature_kind": "access_right", "value": "string", "periodicity_interval": 0, "periodicity_unit": "hour", "price_point_type": "ProductPricePoint", "price_point_id": 0, "archived_at": "2019-08-24T14:15:22Z", "created_at": "2019-08-24T14:15:22Z", "updated_at": "2019-08-24T14:15:22Z" } ] }, "credit_card": { "id": 10088716, "first_name": "Test", "last_name": "Subscription", "masked_card_number": "XXXX-XXXX-XXXX-1", "card_type": "bogus", "expiration_month": 1, "expiration_year": 2022, "customer_id": 14543792, "current_vault": "bogus", "vault_token": "1", "billing_address": "123 Montana Way", "billing_city": "Billings", "billing_state": "MT", "billing_zip": "59101", "billing_country": "US", "customer_vault_token": null, "billing_address_2": "", "payment_type": "credit_card", "site_gateway_setting_id": 1, "gateway_handle": null }, "group": { "uid": "string", "scheme": 0, "primary_subscription_id": 0, "primary": true }, "bank_account": { "id": 0, "first_name": "string", "last_name": "string", "customer_id": 0, "current_vault": "authorizenet", "vault_token": "string", "billing_address": "string", "billing_city": "string", "billing_state": "string", "billing_zip": "string", "billing_country": "string", "customer_vault_token": "string", "billing_address_2": "string", "bank_name": "string", "masked_bank_routing_number": "string", "masked_bank_account_number": "string", "bank_account_type": "checking", "bank_account_holder_type": "personal", "payment_type": "bank_account", "verified": false, "site_gateway_setting_id": 0, "gateway_handle": "string", "created_at": "2019-08-24T14:15:22Z", "updated_at": "2019-08-24T14:15:22Z" }, "payment_type": "string", "referral_code": "string", "next_product_id": 0, "next_product_handle": "string", "coupon_use_count": 0, "coupon_uses_allowed": 0, "reason_code": "string", "automatically_resume_at": "2019-08-24T14:15:22Z", "coupon_codes": [ "string" ], "offer_id": 0, "payer_id": 0, "current_billing_amount_in_cents": 0, "product_price_point_id": 0, "product_price_point_type": "catalog", "next_product_price_point_id": 0, "net_terms": 0, "stored_credential_transaction_id": 0, "reference": "string", "on_hold_at": "2019-08-24T14:15:22Z", "prepaid_dunning": true, "coupons": [ { "code": "string", "use_count": 0, "uses_allowed": 0, "expires_at": "string", "recurring": true, "amount_in_cents": 0, "percentage": "string" } ], "dunning_communication_delay_enabled": true, "dunning_communication_delay_time_zone": "string", "receives_invoice_emails": true, "locale": "string", "currency": "string", "scheduled_cancellation_at": "2019-08-24T14:15:22Z", "credit_balance_in_cents": 0, "prepayment_balance_in_cents": 0, "prepaid_configuration": { "id": 0, "initial_funding_amount_in_cents": 0, "replenish_to_amount_in_cents": 0, "auto_replenish": true, "replenish_threshold_amount_in_cents": 0 }, "self_service_page_token": "string" }}Override Subscription PUT
Sets certain subscription fields that are usually managed automatically. Some of the fields can be set via the normal Subscriptions Update API, but others can only be set using this endpoint. This endpoint is provided for cases where you need to “align” Advanced Billing data with data that happened in your system, perhaps before you started using Advanced Billing. For example, you may choose to import your historical subscription data, and would like the activation and cancellation dates in Advanced Billing to match your existing historical dates. Advanced Billing does not backfill historical events (i.e. from the Events API), but some static data can be changed via this API. Why are some fields only settable from this endpoint, and not the normal subscription create and update endpoints? Because we want users of this endpoint to be aware that these fields are usually managed by Advanced Billing, and using this API means **you are stepping out on your own.** Changing these fields will not affect any other attributes. For example, adding an expiration date will not affect the next assessment date on the subscription. If you regularly need to override the current_period_starts_at for new subscriptions, this can also be accomplished by setting both `previous_billing_at` and `next_billing_at` at subscription creation. See the documentation on [Importing Subscriptions](https://maxio-test-wp.pages.dev/api/openapi/subscriptions/createSubscription) for more information. ## Limitations When passing `current_period_starts_at` some validations are made: 1. The subscription needs to be unbilled (no statements or invoices). 2. The value passed must be a valid date/time. We recommend using the iso 8601 format. 3. The value passed must be before the current date/time. If unpermitted parameters are sent, a 400 HTTP response is sent along with a string giving the reason for the problem.
Purge Subscription POST
Purges an individual subscription for sites in test mode. Provide the subscription ID in the URL. To confirm, supply the customer ID in the query string `ack` parameter. You may also delete the customer record and/or payment profiles by passing `cascade` parameters. For example, to delete just the customer record, the query params would be: `?ack={customer_id}&cascade[]=customer` If you need to remove subscriptions from a live site, contact support to discuss your use case. ### Delete customer and payment profile The query params will be: `?ack={customer_id}&cascade[]=customer&cascade[]=payment_profile`