Plans

Get plan details

Changed on

Retrieve a specific plan. Use ?version=draft for the draft version, ?version=2 for a specific version number, or omit for the active version.

get/api/v1/plans/{plan_id}

Request

  • The document declares no server URL.
  • Auth
    HTTP bearer

Path parameters

plan_idstring MeteroidId required
Example:plan_7n42DGM5Tflk9n8mt7Fhc7

Plan ID

Query parameters

versionstring

Filter by version: "draft", a version number, or omitted for active

Response

Plan details

billing_cyclesinteger nullable
created_atstring date-time required
currencystring required
descriptionstring nullable
idstring MeteroidId required
namestring required
net_termsinteger required
period_start_dayinteger nullable
plan_type'STANDARD' | 'FREE' | 'CUSTOM' required
self_service_rankinteger nullable
status'DRAFT' | 'ACTIVE' | 'INACTIVE' | 'ARCHIVED' required
versioninteger required
version_idstring MeteroidId required

Example response

{
  "entitlements": [
    {
      "feature_id": "feat_7n42DGM5Tflk9n8mt7Fhc7",
      "id": "ent_7n42DGM5Tflk9n8mt7Fhc7"
    }
  ],
  "id": "plan_7n42DGM5Tflk9n8mt7Fhc7",
  "price_components": [
    {
      "fee": {
        "metric_id": "bm_7n42DGM5Tflk9n8mt7Fhc7"
      },
      "id": "price_7n42DGM5Tflk9n8mt7Fhc7",
      "product_id": "prd_7n42DGM5Tflk9n8mt7Fhc7"
    }
  ],
  "product_family": {
    "id": "pf_7n42DGM5Tflk9n8mt7Fhc7"
  },
  "trial": {
    "trialing_plan_id": "plan_7n42DGM5Tflk9n8mt7Fhc7"
  },
  "version_id": "plv_7n42DGM5Tflk9n8mt7Fhc7"
}

Changes

  • v14e013b4e4a8fRevision changes
    • breaking

      the response property ////////////////// became nullable for the status

    • breaking

      the response property ////////////////// became nullable for the status

    • breaking

      the response property ////////////////// became nullable for the status

    • breaking

      the response property ////////////////// became nullable for the status

    • breaking

      the response property ////////////////// became optional for the status

    • breaking

      the response property ////////////////// became optional for the status

    • breaking

      the response property ////////////////// became optional for the status

    • breaking

      the response property ////////////////// became optional for the status

  • v107a61fe347a5Revision changes
    • breaking

      removed the required property /////// from the response with the status

    • warning

      removed the optional property /////// from the response with the status