Zuplo
The Zuplo Developer API, powered by Zuplo

​Metering - Subscriptions

API Metering subscriptions

Endpoint:https://dev.zuplo.com

​Lists subscriptions

GET
https://dev.zuplo.com
/v1/metering/{bucketId}/subscriptions

Lists all subscriptions belonging to this bucket.

​Lists subscriptions › path Parameters

  • bucketIdstring · required

    The id of the bucket. Zuplo automatically creates buckets for your project. You can find it in your Zuplo Portal under the Settings tab for your project.

​Lists subscriptions › Responses

    • dataobject[] · required
    • limitinteger · uint32
    • offsetinteger · uint32
    • totalinteger · uint32

​Creates a subscription

POST
https://dev.zuplo.com
/v1/metering/{bucketId}/subscriptions

Creates a new subscription for this bucket.

​Creates a subscription › path Parameters

  • bucketIdstring · required

    The id of the bucket. Zuplo automatically creates buckets for your project. You can find it in your Zuplo Portal under the Settings tab for your project.

​Creates a subscription › Request Body

  • planIdsstring[] · required
  • planExternalIdsstring[] · required
  • statusstring · enum · required
    Enum values:
    active
    inactive
    incomplete
    incomplete-expired
    trialing
    past-due
    canceled
    unpaid
  • typestring · enum · required
    Enum values:
    periodic
  • renewalStrategystring · enum · required
    Enum values:
    monthly
    yearly
  • regionstring · enum · required
    Enum values:
    us-central1
    us-east1
    europe-west4
  • customerKeystring · required
  • subscriptionExternalIdstring · required
  • customerExternalIdstring · required
  • quotaResetAnchorstring · date-time
  • metadataobject
  • trialEndStatusstring
  • trialEndDatestring · date-time
  • trialStartDatestring · date-time
  • nextBillingCyclestring · date-time
  • productKeystring

​Creates a subscription › Responses

    • createdOnstring · date-time · readOnly · required

      When the item was created.

    • updatedOnstring · date-time · readOnly · required

      When the item was last updated.

    • idstring · readOnly · required
    • planIdsstring[] · required
    • planExternalIdsstring[] · required
    • statusstring · enum · required
      Enum values:
      active
      inactive
      incomplete
      incomplete-expired
      trialing
      past-due
      canceled
      unpaid
    • typestring · enum · required
      Enum values:
      periodic
    • renewalStrategystring · enum · required
      Enum values:
      monthly
      yearly
    • regionstring · enum · required
      Enum values:
      us-central1
      us-east1
      europe-west4
    • customerKeystring · required
    • subscriptionExternalIdstring · required
    • customerExternalIdstring · required
    • quotaResetAnchorstring · date-time
    • metadataobject
    • trialEndStatusstring
    • trialEndDatestring · date-time
    • trialStartDatestring · date-time
    • nextBillingCyclestring · date-time
    • productKeystring

​Gets a subscription

GET
https://dev.zuplo.com
/v1/metering/{bucketId}/subscriptions/{subscriptionId}

Returns the details for a subscription.

​Gets a subscription › path Parameters

  • bucketIdstring · required

    The id of the bucket. Zuplo automatically creates buckets for your project. You can find it in your Zuplo Portal under the Settings tab for your project.

  • subscriptionIdstring · required

    The id of the subscription.

​Gets a subscription › Responses

    • createdOnstring · date-time · readOnly · required

      When the item was created.

    • updatedOnstring · date-time · readOnly · required

      When the item was last updated.

    • idstring · readOnly · required
    • planIdsstring[] · required
    • planExternalIdsstring[] · required
    • statusstring · enum · required
      Enum values:
      active
      inactive
      incomplete
      incomplete-expired
      trialing
      past-due
      canceled
      unpaid
    • typestring · enum · required
      Enum values:
      periodic
    • renewalStrategystring · enum · required
      Enum values:
      monthly
      yearly
    • regionstring · enum · required
      Enum values:
      us-central1
      us-east1
      europe-west4
    • customerKeystring · required
    • subscriptionExternalIdstring · required
    • customerExternalIdstring · required
    • quotaResetAnchorstring · date-time
    • metadataobject
    • trialEndStatusstring
    • trialEndDatestring · date-time
    • trialStartDatestring · date-time
    • nextBillingCyclestring · date-time
    • productKeystring

​Deletes a subscription

DELETE
https://dev.zuplo.com
/v1/metering/{bucketId}/subscriptions/{subscriptionId}

Deletes a subscription and any related resources

​Deletes a subscription › path Parameters

  • bucketIdstring · required

    The id of the bucket. Zuplo automatically creates buckets for your project. You can find it in your Zuplo Portal under the Settings tab for your project.

  • subscriptionIdstring · required

    The id of the subscription.

​Deletes a subscription › Responses

    No response specified

​Updates a subscription

PATCH
https://dev.zuplo.com
/v1/metering/{bucketId}/subscriptions/{subscriptionId}

Updates the subscription for this bucket.

​Updates a subscription › path Parameters

  • bucketIdstring · required

    The id of the bucket. Zuplo automatically creates buckets for your project. You can find it in your Zuplo Portal under the Settings tab for your project.

  • subscriptionIdstring · required

    The id of the subscription.

​Updates a subscription › Request Body

  • planExternalIdsstring[]
  • statusstring · enum
    Enum values:
    active
    inactive
    incomplete
    incomplete-expired
    trialing
    past-due
    canceled
    unpaid
  • proratenumber
  • metadataobject
  • trialEndDatestring · date-time

​Updates a subscription › Responses

    • createdOnstring · date-time · readOnly · required

      When the item was created.

    • updatedOnstring · date-time · readOnly · required

      When the item was last updated.

    • idstring · readOnly · required
    • planIdsstring[] · required
    • planExternalIdsstring[] · required
    • statusstring · enum · required
      Enum values:
      active
      inactive
      incomplete
      incomplete-expired
      trialing
      past-due
      canceled
      unpaid
    • typestring · enum · required
      Enum values:
      periodic
    • renewalStrategystring · enum · required
      Enum values:
      monthly
      yearly
    • regionstring · enum · required
      Enum values:
      us-central1
      us-east1
      europe-west4
    • customerKeystring · required
    • subscriptionExternalIdstring · required
    • customerExternalIdstring · required
    • quotaResetAnchorstring · date-time
    • metadataobject
    • trialEndStatusstring
    • trialEndDatestring · date-time
    • trialStartDatestring · date-time
    • nextBillingCyclestring · date-time
    • productKeystring