The Zuplo Developer API, powered by Zuplo

Metering - Plans

API Metering plan management


Endpoint:https://dev.zuplo.com

Lists plans

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

Lists all plans belonging to this bucket.

Lists planspath 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 plansResponses

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

Creates a plan

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

Creates a new plan for this bucket.

Creates a planpath 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 planRequest Body

  • labelstring · required
  • planExternalIdstring · required
  • metersobject · required
  • trialDaysinteger
  • trialEndStatusstring · enum
    Enum values:
    paused
    canceled
  • isTrialCollectPaymentboolean

Creates a planResponses

    • createdOnstring · date-time · readOnly · required

      When the item was created.

    • updatedOnstring · date-time · readOnly · required

      When the item was last updated.

    • idstring · readOnly · required
    • hasSubscriptionsboolean · readOnly · required
    • labelstring · required
    • planExternalIdstring · required
    • metersobject · required
    • trialDaysinteger
    • trialEndStatusstring · enum
      Enum values:
      paused
      canceled
    • isTrialCollectPaymentboolean

Gets a plan

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

Returns the details for a plan.

Gets a planpath 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.

  • planIdstring · required

    The id of the plan.

Gets a planResponses

    • createdOnstring · date-time · readOnly · required

      When the item was created.

    • updatedOnstring · date-time · readOnly · required

      When the item was last updated.

    • idstring · readOnly · required
    • hasSubscriptionsboolean · readOnly · required
    • labelstring · required
    • planExternalIdstring · required
    • metersobject · required
    • trialDaysinteger
    • trialEndStatusstring · enum
      Enum values:
      paused
      canceled
    • isTrialCollectPaymentboolean

Deletes a plan

DELETE
https://dev.zuplo.com
/v1/metering/{bucketId}/plans/{planId}

Deletes a plan (if there are no associated subscriptions)

Deletes a planpath 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.

  • planIdstring · required

    The id of the plan.

Deletes a planResponses

    No response specified

Updates a plan

PATCH
https://dev.zuplo.com
/v1/metering/{bucketId}/plans/{planId}

Update the details for a plan

Updates a planpath 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.

  • planIdstring · required

    The id of the plan.

Updates a planRequest Body

  • labelstring
  • planExternalIdstring
  • metersobject
  • trialDaysinteger
  • trialEndStatusstring · enum
    Enum values:
    paused
    canceled
  • isTrialCollectPaymentboolean

Updates a planResponses

    • createdOnstring · date-time · readOnly · required

      When the item was created.

    • updatedOnstring · date-time · readOnly · required

      When the item was last updated.

    • idstring · readOnly · required
    • hasSubscriptionsboolean · readOnly · required
    • labelstring · required
    • planExternalIdstring · required
    • metersobject · required
    • trialDaysinteger
    • trialEndStatusstring · enum
      Enum values:
      paused
      canceled
    • isTrialCollectPaymentboolean