API Documentation

API Endpoint

Organization Subscriptions

Organization Subscriptions

Supported Enumerations

Payment methods:

  • credit_card (payment_method_id: 1)

  • invoice (payment_method_id: 2)

GET /api/v2/organization_subscriptions/1
Requestsreturns organization subscriptionreturns organization subscription

GET  /api/v2/organization_subscriptions/790

Headers
Accept: text/xml,application/xml,application/xhtml+xml,text/html;q=0.9,text/plain;q=0.8,image/png,*/*;q=0.5
Content-Type: application/vnd.api+json
Responses200
Headers
Content-Type: application/vnd.api+json; charset=utf-8
Body
{
  "data": {
    "id": "790",
    "type": "organization_subscriptions",
    "attributes": {
      "billing_email": null,
      "billing_address": null,
      "subscription_state_id": 1,
      "trial_ends_at": null,
      "subscription_started_at": null,
      "subscription_ended_at": null,
      "next_billing_cycle_at": null,
      "grace_period_ends_at": null,
      "plan_price": 39,
      "discount": null,
      "discount_expires_on": null,
      "plan_cycle": "month",
      "current_plan": {
        "id": "ultimate",
        "name": "Ultimate",
        "type": null,
        "monthly_price_cents": 3900,
        "yearly_price_cents": 38400,
        "quarterly_price_cents": null,
        "currency": "USD",
        "discontinued": false,
        "tiers": [],
        "annual_tiers": [],
        "quarterly_tiers": [],
        "biannual_tiers": [],
        "upgrades": [],
        "downgrades": [
          "new_essential",
          "professional"
        ],
        "active_products": [],
        "buyable_products": [],
        "features": {},
        "cycle_change_enabled": true,
        "cycle_change_error": null,
        "upgradeables": [],
        "downgradeables": [
          {
            "id": "new_essential",
            "name": "Essential",
            "type": null,
            "monthly_price_cents": 1100,
            "yearly_price_cents": 10800,
            "quarterly_price_cents": null,
            "currency": "USD",
            "discontinued": false,
            "tiers": [],
            "annual_tiers": [],
            "quarterly_tiers": [],
            "biannual_tiers": [],
            "upgrades": [
              "professional",
              "ultimate"
            ],
            "downgrades": [],
            "features": {},
            "buyable": true,
            "trialable": false
          },
          {
            "id": "professional",
            "name": "Professional",
            "type": null,
            "monthly_price_cents": 2800,
            "yearly_price_cents": 28800,
            "quarterly_price_cents": null,
            "currency": "USD",
            "discontinued": false,
            "tiers": [],
            "annual_tiers": [],
            "quarterly_tiers": [],
            "biannual_tiers": [],
            "upgrades": [
              "ultimate"
            ],
            "downgrades": [
              "new_essential"
            ],
            "features": {},
            "buyable": true,
            "trialable": false
          }
        ]
      },
      "plan_type": "ultimate",
      "payment_method_id": 1,
      "seats": 1,
      "seats_used": 1,
      "seats_pending": 1,
      "trial_plan_ends_at": null,
      "trial_plan_type": null,
      "trial_plan_active": false,
      "active_products": {},
      "billing_group_admin": false,
      "billing_group_member": false,
      "billing_group_seats": null,
      "card_brand": null,
      "card_last4": null,
      "card_month": null,
      "card_year": null,
      "contract_date": null,
      "contract_seats": null,
      "contract_min_seats": null,
      "stripe_customer_id": "cus_MfjzMZLrVonbx9",
      "balance": "0.0"
    },
    "relationships": {
      "organization": {
        "data": {
          "type": "organizations",
          "id": "790"
        }
      },
      "billing_group_owner": {
        "meta": {
          "included": false
        }
      },
      "billing_group_members": {
        "meta": {
          "included": false
        }
      }
    }
  },
  "meta": {}
}

GET  /api/v2/organization_subscriptions/814

Headers
Accept: text/xml,application/xml,application/xhtml+xml,text/html;q=0.9,text/plain;q=0.8,image/png,*/*;q=0.5
Content-Type: application/vnd.api+json
Responses200
Headers
Content-Type: application/vnd.api+json; charset=utf-8
Body
{
  "data": {
    "id": "814",
    "type": "organization_subscriptions",
    "attributes": {
      "billing_email": null,
      "billing_address": null,
      "subscription_state_id": 1,
      "trial_ends_at": null,
      "subscription_started_at": null,
      "subscription_ended_at": null,
      "next_billing_cycle_at": null,
      "grace_period_ends_at": null,
      "plan_price": 24,
      "discount": null,
      "discount_expires_on": null,
      "plan_cycle": "month",
      "current_plan": {
        "id": "premium",
        "name": "Premium",
        "type": null,
        "monthly_price_cents": 2400,
        "yearly_price_cents": 24000,
        "quarterly_price_cents": null,
        "currency": "USD",
        "discontinued": true,
        "tiers": [],
        "annual_tiers": [],
        "quarterly_tiers": [],
        "biannual_tiers": [],
        "upgrades": [
          "ultimate"
        ],
        "downgrades": [],
        "active_products": [],
        "buyable_products": [],
        "features": {},
        "cycle_change_enabled": false,
        "cycle_change_error": "plan_discontinued",
        "upgradeables": [
          {
            "id": "ultimate",
            "name": "Ultimate",
            "type": null,
            "monthly_price_cents": 3900,
            "yearly_price_cents": 38400,
            "quarterly_price_cents": null,
            "currency": "USD",
            "discontinued": false,
            "tiers": [],
            "annual_tiers": [],
            "quarterly_tiers": [],
            "biannual_tiers": [],
            "upgrades": [],
            "downgrades": [
              "new_essential",
              "professional"
            ],
            "features": {},
            "buyable": true,
            "trialable": false
          }
        ],
        "downgradeables": []
      },
      "plan_type": "premium",
      "payment_method_id": 1,
      "seats": 1,
      "seats_used": 1,
      "seats_pending": 1,
      "trial_plan_ends_at": null,
      "trial_plan_type": null,
      "trial_plan_active": false,
      "active_products": {},
      "billing_group_admin": false,
      "billing_group_member": false,
      "billing_group_seats": null,
      "card_brand": null,
      "card_last4": null,
      "card_month": null,
      "card_year": null,
      "contract_date": null,
      "contract_seats": null,
      "contract_min_seats": null,
      "stripe_customer_id": "cus_474RjipEtz2ff7",
      "balance": "0.0"
    },
    "relationships": {
      "organization": {
        "data": {
          "type": "organizations",
          "id": "814"
        }
      },
      "billing_group_owner": {
        "meta": {
          "included": false
        }
      },
      "billing_group_members": {
        "meta": {
          "included": false
        }
      }
    }
  },
  "meta": {}
}

Gets a organization subscription
GET/api/v2/organization_subscriptions/{id}

URI Parameters
HideShow
id
number (required) Example: 1

organization subscription id

PATCH /api/v2/organization_subscriptions/1
Requestscreates subscriptionsets trial plansets trial plandoes not change trial plandoes not change trial plansets trial_plan to nullupdates subscriptionupdates subscriptionupdates subscriptionupdates subscriptionupdates subscriptionupdates subscriptionupdates subscriptionreturns errorcreates subscriptionsets trial plan when plan is set upon monthly standard plandoes not change trial plan when plan changes cycledoes not change trial plan when plan changesets trial_plan to null when undefinedraises error when cycle changed from monthly to yearlyraises error when switching from standard to premiumraises error when switching from standard to new premiumraises error when switching from new premium to standardis valid when switching from new premium to ultimateraises error when switching from premium yearly to standard monthlyupdates subscription

PATCH  /api/v2/organization_subscriptions/791

Headers
Accept: text/xml,application/xml,application/xhtml+xml,text/html;q=0.9,text/plain;q=0.8,image/png,*/*;q=0.5
Content-Type: application/vnd.api+json
Body
{
  "data": {
    "type": "organization_subscriptions",
    "attributes": {
      "stripe_token": "tok_u5dg20Gra",
      "seats": 3
    }
  }
}
Responses200
Headers
Content-Type: application/vnd.api+json; charset=utf-8
Body
{
  "data": {
    "id": "791",
    "type": "organization_subscriptions",
    "attributes": {
      "billing_email": null,
      "billing_address": null,
      "subscription_state_id": null,
      "trial_ends_at": null,
      "subscription_started_at": null,
      "subscription_ended_at": null,
      "next_billing_cycle_at": null,
      "grace_period_ends_at": null,
      "plan_price": 39,
      "discount": null,
      "discount_expires_on": null,
      "plan_cycle": "month",
      "current_plan": {
        "id": "ultimate",
        "name": "Ultimate",
        "type": null,
        "monthly_price_cents": 3900,
        "yearly_price_cents": 38400,
        "quarterly_price_cents": null,
        "currency": "USD",
        "discontinued": false,
        "tiers": [],
        "annual_tiers": [],
        "quarterly_tiers": [],
        "biannual_tiers": [],
        "upgrades": [],
        "downgrades": [
          "new_essential",
          "professional"
        ],
        "active_products": [],
        "buyable_products": [],
        "features": {},
        "cycle_change_enabled": true,
        "cycle_change_error": null,
        "upgradeables": [],
        "downgradeables": [
          {
            "id": "new_essential",
            "name": "Essential",
            "type": null,
            "monthly_price_cents": 1100,
            "yearly_price_cents": 10800,
            "quarterly_price_cents": null,
            "currency": "USD",
            "discontinued": false,
            "tiers": [],
            "annual_tiers": [],
            "quarterly_tiers": [],
            "biannual_tiers": [],
            "upgrades": [
              "professional",
              "ultimate"
            ],
            "downgrades": [],
            "features": {},
            "buyable": true,
            "trialable": false
          },
          {
            "id": "professional",
            "name": "Professional",
            "type": null,
            "monthly_price_cents": 2800,
            "yearly_price_cents": 28800,
            "quarterly_price_cents": null,
            "currency": "USD",
            "discontinued": false,
            "tiers": [],
            "annual_tiers": [],
            "quarterly_tiers": [],
            "biannual_tiers": [],
            "upgrades": [
              "ultimate"
            ],
            "downgrades": [
              "new_essential"
            ],
            "features": {},
            "buyable": true,
            "trialable": false
          }
        ]
      },
      "plan_type": "ultimate",
      "payment_method_id": 1,
      "seats": 3,
      "seats_used": 1,
      "seats_pending": 3,
      "trial_plan_ends_at": null,
      "trial_plan_type": null,
      "trial_plan_active": false,
      "active_products": {},
      "billing_group_admin": false,
      "billing_group_member": false,
      "billing_group_seats": null,
      "card_brand": null,
      "card_last4": null,
      "card_month": null,
      "card_year": null,
      "contract_date": null,
      "contract_seats": null,
      "contract_min_seats": null,
      "stripe_customer_id": "cus_without_subs",
      "balance": "0.0"
    },
    "relationships": {
      "organization": {
        "data": {
          "type": "organizations",
          "id": "791"
        }
      },
      "billing_group_owner": {
        "meta": {
          "included": false
        }
      },
      "billing_group_members": {
        "meta": {
          "included": false
        }
      }
    }
  },
  "meta": {}
}

PATCH  /api/v2/organization_subscriptions/792

Headers
Accept: text/xml,application/xml,application/xhtml+xml,text/html;q=0.9,text/plain;q=0.8,image/png,*/*;q=0.5
Content-Type: application/vnd.api+json
Body
{
  "data": {
    "type": "organization_subscriptions",
    "attributes": {
      "trial_plan_type": "ultimate"
    }
  }
}
Responses200
Headers
Content-Type: application/vnd.api+json; charset=utf-8
Body
{
  "data": {
    "id": "792",
    "type": "organization_subscriptions",
    "attributes": {
      "billing_email": null,
      "billing_address": null,
      "subscription_state_id": 2,
      "trial_ends_at": null,
      "subscription_started_at": null,
      "subscription_ended_at": null,
      "next_billing_cycle_at": null,
      "grace_period_ends_at": null,
      "plan_price": 28,
      "discount": null,
      "discount_expires_on": null,
      "plan_cycle": "month",
      "current_plan": {
        "id": "professional",
        "name": "Professional",
        "type": null,
        "monthly_price_cents": 2800,
        "yearly_price_cents": 28800,
        "quarterly_price_cents": null,
        "currency": "USD",
        "discontinued": false,
        "tiers": [],
        "annual_tiers": [],
        "quarterly_tiers": [],
        "biannual_tiers": [],
        "upgrades": [
          "ultimate"
        ],
        "downgrades": [
          "new_essential"
        ],
        "active_products": [],
        "buyable_products": [],
        "features": {},
        "cycle_change_enabled": true,
        "cycle_change_error": null,
        "upgradeables": [
          {
            "id": "ultimate",
            "name": "Ultimate",
            "type": null,
            "monthly_price_cents": 3900,
            "yearly_price_cents": 38400,
            "quarterly_price_cents": null,
            "currency": "USD",
            "discontinued": false,
            "tiers": [],
            "annual_tiers": [],
            "quarterly_tiers": [],
            "biannual_tiers": [],
            "upgrades": [],
            "downgrades": [
              "new_essential",
              "professional"
            ],
            "features": {},
            "buyable": true,
            "trialable": false
          }
        ],
        "downgradeables": [
          {
            "id": "new_essential",
            "name": "Essential",
            "type": null,
            "monthly_price_cents": 1100,
            "yearly_price_cents": 10800,
            "quarterly_price_cents": null,
            "currency": "USD",
            "discontinued": false,
            "tiers": [],
            "annual_tiers": [],
            "quarterly_tiers": [],
            "biannual_tiers": [],
            "upgrades": [
              "professional",
              "ultimate"
            ],
            "downgrades": [],
            "features": {},
            "buyable": true,
            "trialable": false
          }
        ]
      },
      "plan_type": "professional",
      "payment_method_id": 1,
      "seats": 1,
      "seats_used": 1,
      "seats_pending": 1,
      "trial_plan_ends_at": "2019-01-15 23:59:59",
      "trial_plan_type": "ultimate",
      "trial_plan_active": true,
      "active_products": {},
      "billing_group_admin": false,
      "billing_group_member": false,
      "billing_group_seats": null,
      "card_brand": null,
      "card_last4": null,
      "card_month": null,
      "card_year": null,
      "contract_date": null,
      "contract_seats": null,
      "contract_min_seats": null,
      "stripe_customer_id": "cus_MfjzMZLrVonbx9",
      "balance": "0.0"
    },
    "relationships": {
      "organization": {
        "data": {
          "type": "organizations",
          "id": "792"
        }
      },
      "billing_group_owner": {
        "meta": {
          "included": false
        }
      },
      "billing_group_members": {
        "meta": {
          "included": false
        }
      }
    }
  },
  "meta": {}
}

PATCH  /api/v2/organization_subscriptions/793

Headers
Accept: text/xml,application/xml,application/xhtml+xml,text/html;q=0.9,text/plain;q=0.8,image/png,*/*;q=0.5
Content-Type: application/vnd.api+json
Body
{
  "data": {
    "type": "organization_subscriptions",
    "attributes": {
      "trial_plan_type": "ultimate",
      "plan_cycle": "year"
    }
  }
}
Responses200
Headers
Content-Type: application/vnd.api+json; charset=utf-8
Body
{
  "data": {
    "id": "793",
    "type": "organization_subscriptions",
    "attributes": {
      "billing_email": null,
      "billing_address": null,
      "subscription_state_id": 2,
      "trial_ends_at": null,
      "subscription_started_at": null,
      "subscription_ended_at": null,
      "next_billing_cycle_at": null,
      "grace_period_ends_at": null,
      "plan_price": 288,
      "discount": null,
      "discount_expires_on": null,
      "plan_cycle": "year",
      "current_plan": {
        "id": "professional",
        "name": "Professional",
        "type": null,
        "monthly_price_cents": 2800,
        "yearly_price_cents": 28800,
        "quarterly_price_cents": null,
        "currency": "USD",
        "discontinued": false,
        "tiers": [],
        "annual_tiers": [],
        "quarterly_tiers": [],
        "biannual_tiers": [],
        "upgrades": [
          "ultimate"
        ],
        "downgrades": [
          "new_essential"
        ],
        "active_products": [],
        "buyable_products": [],
        "features": {},
        "cycle_change_enabled": true,
        "cycle_change_error": null,
        "upgradeables": [
          {
            "id": "ultimate",
            "name": "Ultimate",
            "type": null,
            "monthly_price_cents": 3900,
            "yearly_price_cents": 38400,
            "quarterly_price_cents": null,
            "currency": "USD",
            "discontinued": false,
            "tiers": [],
            "annual_tiers": [],
            "quarterly_tiers": [],
            "biannual_tiers": [],
            "upgrades": [],
            "downgrades": [
              "new_essential",
              "professional"
            ],
            "features": {},
            "buyable": true,
            "trialable": false
          }
        ],
        "downgradeables": [
          {
            "id": "new_essential",
            "name": "Essential",
            "type": null,
            "monthly_price_cents": 1100,
            "yearly_price_cents": 10800,
            "quarterly_price_cents": null,
            "currency": "USD",
            "discontinued": false,
            "tiers": [],
            "annual_tiers": [],
            "quarterly_tiers": [],
            "biannual_tiers": [],
            "upgrades": [
              "professional",
              "ultimate"
            ],
            "downgrades": [],
            "features": {},
            "buyable": true,
            "trialable": false
          }
        ]
      },
      "plan_type": "professional",
      "payment_method_id": 1,
      "seats": 1,
      "seats_used": 1,
      "seats_pending": 1,
      "trial_plan_ends_at": "2019-01-15 23:59:59",
      "trial_plan_type": "ultimate",
      "trial_plan_active": true,
      "active_products": {},
      "billing_group_admin": false,
      "billing_group_member": false,
      "billing_group_seats": null,
      "card_brand": null,
      "card_last4": null,
      "card_month": null,
      "card_year": null,
      "contract_date": null,
      "contract_seats": null,
      "contract_min_seats": null,
      "stripe_customer_id": "cus_MfjzMZLrVonbx9",
      "balance": "0.0"
    },
    "relationships": {
      "organization": {
        "data": {
          "type": "organizations",
          "id": "793"
        }
      },
      "billing_group_owner": {
        "meta": {
          "included": false
        }
      },
      "billing_group_members": {
        "meta": {
          "included": false
        }
      }
    }
  },
  "meta": {}
}

PATCH  /api/v2/organization_subscriptions/794

Headers
Accept: text/xml,application/xml,application/xhtml+xml,text/html;q=0.9,text/plain;q=0.8,image/png,*/*;q=0.5
Content-Type: application/vnd.api+json
Body
{
  "data": {
    "type": "organization_subscriptions",
    "attributes": {
      "plan_cycle": "year"
    }
  }
}
Responses200
Headers
Content-Type: application/vnd.api+json; charset=utf-8
Body
{
  "data": {
    "id": "794",
    "type": "organization_subscriptions",
    "attributes": {
      "billing_email": null,
      "billing_address": null,
      "subscription_state_id": null,
      "trial_ends_at": null,
      "subscription_started_at": null,
      "subscription_ended_at": null,
      "next_billing_cycle_at": null,
      "grace_period_ends_at": null,
      "plan_price": 108,
      "discount": null,
      "discount_expires_on": null,
      "plan_cycle": "year",
      "current_plan": {
        "id": "new_essential",
        "name": "Essential",
        "type": null,
        "monthly_price_cents": 1100,
        "yearly_price_cents": 10800,
        "quarterly_price_cents": null,
        "currency": "USD",
        "discontinued": false,
        "tiers": [],
        "annual_tiers": [],
        "quarterly_tiers": [],
        "biannual_tiers": [],
        "upgrades": [
          "professional",
          "ultimate"
        ],
        "downgrades": [],
        "active_products": [],
        "buyable_products": [],
        "features": {},
        "cycle_change_enabled": true,
        "cycle_change_error": null,
        "upgradeables": [
          {
            "id": "professional",
            "name": "Professional",
            "type": null,
            "monthly_price_cents": 2800,
            "yearly_price_cents": 28800,
            "quarterly_price_cents": null,
            "currency": "USD",
            "discontinued": false,
            "tiers": [],
            "annual_tiers": [],
            "quarterly_tiers": [],
            "biannual_tiers": [],
            "upgrades": [
              "ultimate"
            ],
            "downgrades": [
              "new_essential"
            ],
            "features": {},
            "buyable": true,
            "trialable": false
          },
          {
            "id": "ultimate",
            "name": "Ultimate",
            "type": null,
            "monthly_price_cents": 3900,
            "yearly_price_cents": 38400,
            "quarterly_price_cents": null,
            "currency": "USD",
            "discontinued": false,
            "tiers": [],
            "annual_tiers": [],
            "quarterly_tiers": [],
            "biannual_tiers": [],
            "upgrades": [],
            "downgrades": [
              "new_essential",
              "professional"
            ],
            "features": {},
            "buyable": true,
            "trialable": false
          }
        ],
        "downgradeables": []
      },
      "plan_type": "new_essential",
      "payment_method_id": 1,
      "seats": 1,
      "seats_used": 1,
      "seats_pending": 1,
      "trial_plan_ends_at": "2019-01-08 23:59:59",
      "trial_plan_type": "ultimate",
      "trial_plan_active": true,
      "active_products": {},
      "billing_group_admin": false,
      "billing_group_member": false,
      "billing_group_seats": null,
      "card_brand": null,
      "card_last4": null,
      "card_month": null,
      "card_year": null,
      "contract_date": null,
      "contract_seats": null,
      "contract_min_seats": null,
      "stripe_customer_id": "cus_MfjzMZLrVonbx9",
      "balance": "0.0"
    },
    "relationships": {
      "organization": {
        "data": {
          "type": "organizations",
          "id": "794"
        }
      },
      "billing_group_owner": {
        "meta": {
          "included": false
        }
      },
      "billing_group_members": {
        "meta": {
          "included": false
        }
      }
    }
  },
  "meta": {}
}

PATCH  /api/v2/organization_subscriptions/795

Headers
Accept: text/xml,application/xml,application/xhtml+xml,text/html;q=0.9,text/plain;q=0.8,image/png,*/*;q=0.5
Content-Type: application/vnd.api+json
Body
{
  "data": {
    "type": "organization_subscriptions",
    "attributes": {
      "plan_type": "ultimate"
    }
  }
}
Responses200
Headers
Content-Type: application/vnd.api+json; charset=utf-8
Body
{
  "data": {
    "id": "795",
    "type": "organization_subscriptions",
    "attributes": {
      "billing_email": null,
      "billing_address": null,
      "subscription_state_id": null,
      "trial_ends_at": null,
      "subscription_started_at": null,
      "subscription_ended_at": null,
      "next_billing_cycle_at": null,
      "grace_period_ends_at": null,
      "plan_price": 39,
      "discount": null,
      "discount_expires_on": null,
      "plan_cycle": "month",
      "current_plan": {
        "id": "ultimate",
        "name": "Ultimate",
        "type": null,
        "monthly_price_cents": 3900,
        "yearly_price_cents": 38400,
        "quarterly_price_cents": null,
        "currency": "USD",
        "discontinued": false,
        "tiers": [],
        "annual_tiers": [],
        "quarterly_tiers": [],
        "biannual_tiers": [],
        "upgrades": [],
        "downgrades": [
          "new_essential",
          "professional"
        ],
        "active_products": [],
        "buyable_products": [],
        "features": {},
        "cycle_change_enabled": true,
        "cycle_change_error": null,
        "upgradeables": [],
        "downgradeables": [
          {
            "id": "new_essential",
            "name": "Essential",
            "type": null,
            "monthly_price_cents": 1100,
            "yearly_price_cents": 10800,
            "quarterly_price_cents": null,
            "currency": "USD",
            "discontinued": false,
            "tiers": [],
            "annual_tiers": [],
            "quarterly_tiers": [],
            "biannual_tiers": [],
            "upgrades": [
              "professional",
              "ultimate"
            ],
            "downgrades": [],
            "features": {},
            "buyable": true,
            "trialable": false
          },
          {
            "id": "professional",
            "name": "Professional",
            "type": null,
            "monthly_price_cents": 2800,
            "yearly_price_cents": 28800,
            "quarterly_price_cents": null,
            "currency": "USD",
            "discontinued": false,
            "tiers": [],
            "annual_tiers": [],
            "quarterly_tiers": [],
            "biannual_tiers": [],
            "upgrades": [
              "ultimate"
            ],
            "downgrades": [
              "new_essential"
            ],
            "features": {},
            "buyable": true,
            "trialable": false
          }
        ]
      },
      "plan_type": "ultimate",
      "payment_method_id": 1,
      "seats": 1,
      "seats_used": 1,
      "seats_pending": 1,
      "trial_plan_ends_at": "2019-01-08 23:59:59",
      "trial_plan_type": "ultimate",
      "trial_plan_active": true,
      "active_products": {},
      "billing_group_admin": false,
      "billing_group_member": false,
      "billing_group_seats": null,
      "card_brand": null,
      "card_last4": null,
      "card_month": null,
      "card_year": null,
      "contract_date": null,
      "contract_seats": null,
      "contract_min_seats": null,
      "stripe_customer_id": "cus_MfjzMZLrVonbx9",
      "balance": "0.0"
    },
    "relationships": {
      "organization": {
        "data": {
          "type": "organizations",
          "id": "795"
        }
      },
      "billing_group_owner": {
        "meta": {
          "included": false
        }
      },
      "billing_group_members": {
        "meta": {
          "included": false
        }
      }
    }
  },
  "meta": {}
}

PATCH  /api/v2/organization_subscriptions/796

Headers
Accept: text/xml,application/xml,application/xhtml+xml,text/html;q=0.9,text/plain;q=0.8,image/png,*/*;q=0.5
Content-Type: application/vnd.api+json
Body
{
  "data": {
    "type": "organization_subscriptions",
    "attributes": {
      "trial_plan_type": null
    }
  }
}
Responses200
Headers
Content-Type: application/vnd.api+json; charset=utf-8
Body
{
  "data": {
    "id": "796",
    "type": "organization_subscriptions",
    "attributes": {
      "billing_email": null,
      "billing_address": null,
      "subscription_state_id": null,
      "trial_ends_at": null,
      "subscription_started_at": null,
      "subscription_ended_at": null,
      "next_billing_cycle_at": null,
      "grace_period_ends_at": null,
      "plan_price": 288,
      "discount": null,
      "discount_expires_on": null,
      "plan_cycle": "year",
      "current_plan": {
        "id": "professional",
        "name": "Professional",
        "type": null,
        "monthly_price_cents": 2800,
        "yearly_price_cents": 28800,
        "quarterly_price_cents": null,
        "currency": "USD",
        "discontinued": false,
        "tiers": [],
        "annual_tiers": [],
        "quarterly_tiers": [],
        "biannual_tiers": [],
        "upgrades": [
          "ultimate"
        ],
        "downgrades": [
          "new_essential"
        ],
        "active_products": [],
        "buyable_products": [],
        "features": {},
        "cycle_change_enabled": true,
        "cycle_change_error": null,
        "upgradeables": [
          {
            "id": "ultimate",
            "name": "Ultimate",
            "type": null,
            "monthly_price_cents": 3900,
            "yearly_price_cents": 38400,
            "quarterly_price_cents": null,
            "currency": "USD",
            "discontinued": false,
            "tiers": [],
            "annual_tiers": [],
            "quarterly_tiers": [],
            "biannual_tiers": [],
            "upgrades": [],
            "downgrades": [
              "new_essential",
              "professional"
            ],
            "features": {},
            "buyable": true,
            "trialable": false
          }
        ],
        "downgradeables": [
          {
            "id": "new_essential",
            "name": "Essential",
            "type": null,
            "monthly_price_cents": 1100,
            "yearly_price_cents": 10800,
            "quarterly_price_cents": null,
            "currency": "USD",
            "discontinued": false,
            "tiers": [],
            "annual_tiers": [],
            "quarterly_tiers": [],
            "biannual_tiers": [],
            "upgrades": [
              "professional",
              "ultimate"
            ],
            "downgrades": [],
            "features": {},
            "buyable": true,
            "trialable": false
          }
        ]
      },
      "plan_type": "professional",
      "payment_method_id": 1,
      "seats": 1,
      "seats_used": 1,
      "seats_pending": 1,
      "trial_plan_ends_at": "2019-01-08 23:59:59",
      "trial_plan_type": null,
      "trial_plan_active": true,
      "active_products": {},
      "billing_group_admin": false,
      "billing_group_member": false,
      "billing_group_seats": null,
      "card_brand": null,
      "card_last4": null,
      "card_month": null,
      "card_year": null,
      "contract_date": null,
      "contract_seats": null,
      "contract_min_seats": null,
      "stripe_customer_id": "cus_MfjzMZLrVonbx9",
      "balance": "0.0"
    },
    "relationships": {
      "organization": {
        "data": {
          "type": "organizations",
          "id": "796"
        }
      },
      "billing_group_owner": {
        "meta": {
          "included": false
        }
      },
      "billing_group_members": {
        "meta": {
          "included": false
        }
      }
    }
  },
  "meta": {}
}

PATCH  /api/v2/organization_subscriptions/797

Headers
Accept: text/xml,application/xml,application/xhtml+xml,text/html;q=0.9,text/plain;q=0.8,image/png,*/*;q=0.5
Content-Type: application/vnd.api+json
Body
{
  "data": {
    "type": "organization_subscriptions",
    "attributes": {
      "plan_cycle": "year"
    }
  }
}
Responses200
Headers
Content-Type: application/vnd.api+json; charset=utf-8
Body
{
  "data": {
    "id": "797",
    "type": "organization_subscriptions",
    "attributes": {
      "billing_email": null,
      "billing_address": null,
      "subscription_state_id": null,
      "trial_ends_at": null,
      "subscription_started_at": null,
      "subscription_ended_at": null,
      "next_billing_cycle_at": null,
      "grace_period_ends_at": null,
      "plan_price": 384,
      "discount": null,
      "discount_expires_on": null,
      "plan_cycle": "year",
      "current_plan": {
        "id": "ultimate",
        "name": "Ultimate",
        "type": null,
        "monthly_price_cents": 3900,
        "yearly_price_cents": 38400,
        "quarterly_price_cents": null,
        "currency": "USD",
        "discontinued": false,
        "tiers": [],
        "annual_tiers": [],
        "quarterly_tiers": [],
        "biannual_tiers": [],
        "upgrades": [],
        "downgrades": [
          "new_essential",
          "professional"
        ],
        "active_products": [],
        "buyable_products": [],
        "features": {},
        "cycle_change_enabled": true,
        "cycle_change_error": null,
        "upgradeables": [],
        "downgradeables": [
          {
            "id": "new_essential",
            "name": "Essential",
            "type": null,
            "monthly_price_cents": 1100,
            "yearly_price_cents": 10800,
            "quarterly_price_cents": null,
            "currency": "USD",
            "discontinued": false,
            "tiers": [],
            "annual_tiers": [],
            "quarterly_tiers": [],
            "biannual_tiers": [],
            "upgrades": [
              "professional",
              "ultimate"
            ],
            "downgrades": [],
            "features": {},
            "buyable": true,
            "trialable": false
          },
          {
            "id": "professional",
            "name": "Professional",
            "type": null,
            "monthly_price_cents": 2800,
            "yearly_price_cents": 28800,
            "quarterly_price_cents": null,
            "currency": "USD",
            "discontinued": false,
            "tiers": [],
            "annual_tiers": [],
            "quarterly_tiers": [],
            "biannual_tiers": [],
            "upgrades": [
              "ultimate"
            ],
            "downgrades": [
              "new_essential"
            ],
            "features": {},
            "buyable": true,
            "trialable": false
          }
        ]
      },
      "plan_type": "ultimate",
      "payment_method_id": 1,
      "seats": 1,
      "seats_used": 1,
      "seats_pending": 1,
      "trial_plan_ends_at": null,
      "trial_plan_type": null,
      "trial_plan_active": false,
      "active_products": {},
      "billing_group_admin": false,
      "billing_group_member": false,
      "billing_group_seats": null,
      "card_brand": null,
      "card_last4": null,
      "card_month": null,
      "card_year": null,
      "contract_date": null,
      "contract_seats": null,
      "contract_min_seats": null,
      "stripe_customer_id": "cus_MfjzMZLrVonbx9",
      "balance": "0.0"
    },
    "relationships": {
      "organization": {
        "data": {
          "type": "organizations",
          "id": "797"
        }
      },
      "billing_group_owner": {
        "meta": {
          "included": false
        }
      },
      "billing_group_members": {
        "meta": {
          "included": false
        }
      }
    }
  },
  "meta": {}
}

PATCH  /api/v2/organization_subscriptions/798

Headers
Accept: text/xml,application/xml,application/xhtml+xml,text/html;q=0.9,text/plain;q=0.8,image/png,*/*;q=0.5
Content-Type: application/vnd.api+json
Body
{
  "data": {
    "type": "organization_subscriptions",
    "attributes": {
      "plan_type": "ultimate"
    }
  }
}
Responses200
Headers
Content-Type: application/vnd.api+json; charset=utf-8
Body
{
  "data": {
    "id": "798",
    "type": "organization_subscriptions",
    "attributes": {
      "billing_email": null,
      "billing_address": null,
      "subscription_state_id": null,
      "trial_ends_at": null,
      "subscription_started_at": null,
      "subscription_ended_at": null,
      "next_billing_cycle_at": null,
      "grace_period_ends_at": null,
      "plan_price": 39,
      "discount": null,
      "discount_expires_on": null,
      "plan_cycle": "month",
      "current_plan": {
        "id": "ultimate",
        "name": "Ultimate",
        "type": null,
        "monthly_price_cents": 3900,
        "yearly_price_cents": 38400,
        "quarterly_price_cents": null,
        "currency": "USD",
        "discontinued": false,
        "tiers": [],
        "annual_tiers": [],
        "quarterly_tiers": [],
        "biannual_tiers": [],
        "upgrades": [],
        "downgrades": [
          "new_essential",
          "professional"
        ],
        "active_products": [],
        "buyable_products": [],
        "features": {},
        "cycle_change_enabled": true,
        "cycle_change_error": null,
        "upgradeables": [],
        "downgradeables": [
          {
            "id": "new_essential",
            "name": "Essential",
            "type": null,
            "monthly_price_cents": 1100,
            "yearly_price_cents": 10800,
            "quarterly_price_cents": null,
            "currency": "USD",
            "discontinued": false,
            "tiers": [],
            "annual_tiers": [],
            "quarterly_tiers": [],
            "biannual_tiers": [],
            "upgrades": [
              "professional",
              "ultimate"
            ],
            "downgrades": [],
            "features": {},
            "buyable": true,
            "trialable": false
          },
          {
            "id": "professional",
            "name": "Professional",
            "type": null,
            "monthly_price_cents": 2800,
            "yearly_price_cents": 28800,
            "quarterly_price_cents": null,
            "currency": "USD",
            "discontinued": false,
            "tiers": [],
            "annual_tiers": [],
            "quarterly_tiers": [],
            "biannual_tiers": [],
            "upgrades": [
              "ultimate"
            ],
            "downgrades": [
              "new_essential"
            ],
            "features": {},
            "buyable": true,
            "trialable": false
          }
        ]
      },
      "plan_type": "ultimate",
      "payment_method_id": 1,
      "seats": 1,
      "seats_used": 1,
      "seats_pending": 1,
      "trial_plan_ends_at": null,
      "trial_plan_type": null,
      "trial_plan_active": false,
      "active_products": {},
      "billing_group_admin": false,
      "billing_group_member": false,
      "billing_group_seats": null,
      "card_brand": null,
      "card_last4": null,
      "card_month": null,
      "card_year": null,
      "contract_date": null,
      "contract_seats": null,
      "contract_min_seats": null,
      "stripe_customer_id": "cus_MfjzMZLrVonbx9",
      "balance": "0.0"
    },
    "relationships": {
      "organization": {
        "data": {
          "type": "organizations",
          "id": "798"
        }
      },
      "billing_group_owner": {
        "meta": {
          "included": false
        }
      },
      "billing_group_members": {
        "meta": {
          "included": false
        }
      }
    }
  },
  "meta": {}
}

PATCH  /api/v2/organization_subscriptions/799

Headers
Accept: text/xml,application/xml,application/xhtml+xml,text/html;q=0.9,text/plain;q=0.8,image/png,*/*;q=0.5
Content-Type: application/vnd.api+json
Body
{
  "data": {
    "type": "organization_subscriptions",
    "attributes": {
      "plan_type": "new_essential",
      "plan_cycle": "month"
    }
  }
}
Responses200
Headers
Content-Type: application/vnd.api+json; charset=utf-8
Body
{
  "data": {
    "id": "799",
    "type": "organization_subscriptions",
    "attributes": {
      "billing_email": null,
      "billing_address": null,
      "subscription_state_id": null,
      "trial_ends_at": null,
      "subscription_started_at": null,
      "subscription_ended_at": null,
      "next_billing_cycle_at": null,
      "grace_period_ends_at": null,
      "plan_price": 11,
      "discount": null,
      "discount_expires_on": null,
      "plan_cycle": "month",
      "current_plan": {
        "id": "new_essential",
        "name": "Essential",
        "type": null,
        "monthly_price_cents": 1100,
        "yearly_price_cents": 10800,
        "quarterly_price_cents": null,
        "currency": "USD",
        "discontinued": false,
        "tiers": [],
        "annual_tiers": [],
        "quarterly_tiers": [],
        "biannual_tiers": [],
        "upgrades": [
          "professional",
          "ultimate"
        ],
        "downgrades": [],
        "active_products": [],
        "buyable_products": [],
        "features": {},
        "cycle_change_enabled": true,
        "cycle_change_error": null,
        "upgradeables": [
          {
            "id": "professional",
            "name": "Professional",
            "type": null,
            "monthly_price_cents": 2800,
            "yearly_price_cents": 28800,
            "quarterly_price_cents": null,
            "currency": "USD",
            "discontinued": false,
            "tiers": [],
            "annual_tiers": [],
            "quarterly_tiers": [],
            "biannual_tiers": [],
            "upgrades": [
              "ultimate"
            ],
            "downgrades": [
              "new_essential"
            ],
            "features": {},
            "buyable": true,
            "trialable": false
          },
          {
            "id": "ultimate",
            "name": "Ultimate",
            "type": null,
            "monthly_price_cents": 3900,
            "yearly_price_cents": 38400,
            "quarterly_price_cents": null,
            "currency": "USD",
            "discontinued": false,
            "tiers": [],
            "annual_tiers": [],
            "quarterly_tiers": [],
            "biannual_tiers": [],
            "upgrades": [],
            "downgrades": [
              "new_essential",
              "professional"
            ],
            "features": {},
            "buyable": true,
            "trialable": false
          }
        ],
        "downgradeables": []
      },
      "plan_type": "new_essential",
      "payment_method_id": 1,
      "seats": 1,
      "seats_used": 1,
      "seats_pending": 1,
      "trial_plan_ends_at": null,
      "trial_plan_type": null,
      "trial_plan_active": false,
      "active_products": {},
      "billing_group_admin": false,
      "billing_group_member": false,
      "billing_group_seats": null,
      "card_brand": null,
      "card_last4": null,
      "card_month": null,
      "card_year": null,
      "contract_date": null,
      "contract_seats": null,
      "contract_min_seats": null,
      "stripe_customer_id": "cus_MfjzMZLrVonbx9",
      "balance": "0.0"
    },
    "relationships": {
      "organization": {
        "data": {
          "type": "organizations",
          "id": "799"
        }
      },
      "billing_group_owner": {
        "meta": {
          "included": false
        }
      },
      "billing_group_members": {
        "meta": {
          "included": false
        }
      }
    }
  },
  "meta": {}
}

PATCH  /api/v2/organization_subscriptions/800

Headers
Accept: text/xml,application/xml,application/xhtml+xml,text/html;q=0.9,text/plain;q=0.8,image/png,*/*;q=0.5
Content-Type: application/vnd.api+json
Body
{
  "data": {
    "type": "organization_subscriptions",
    "attributes": {
      "plan_cycle": "month"
    }
  }
}
Responses200
Headers
Content-Type: application/vnd.api+json; charset=utf-8
Body
{
  "data": {
    "id": "800",
    "type": "organization_subscriptions",
    "attributes": {
      "billing_email": null,
      "billing_address": null,
      "subscription_state_id": null,
      "trial_ends_at": null,
      "subscription_started_at": null,
      "subscription_ended_at": null,
      "next_billing_cycle_at": null,
      "grace_period_ends_at": null,
      "plan_price": 39,
      "discount": null,
      "discount_expires_on": null,
      "plan_cycle": "month",
      "current_plan": {
        "id": "ultimate",
        "name": "Ultimate",
        "type": null,
        "monthly_price_cents": 3900,
        "yearly_price_cents": 38400,
        "quarterly_price_cents": null,
        "currency": "USD",
        "discontinued": false,
        "tiers": [],
        "annual_tiers": [],
        "quarterly_tiers": [],
        "biannual_tiers": [],
        "upgrades": [],
        "downgrades": [
          "new_essential",
          "professional"
        ],
        "active_products": [],
        "buyable_products": [],
        "features": {},
        "cycle_change_enabled": true,
        "cycle_change_error": null,
        "upgradeables": [],
        "downgradeables": [
          {
            "id": "new_essential",
            "name": "Essential",
            "type": null,
            "monthly_price_cents": 1100,
            "yearly_price_cents": 10800,
            "quarterly_price_cents": null,
            "currency": "USD",
            "discontinued": false,
            "tiers": [],
            "annual_tiers": [],
            "quarterly_tiers": [],
            "biannual_tiers": [],
            "upgrades": [
              "professional",
              "ultimate"
            ],
            "downgrades": [],
            "features": {},
            "buyable": true,
            "trialable": false
          },
          {
            "id": "professional",
            "name": "Professional",
            "type": null,
            "monthly_price_cents": 2800,
            "yearly_price_cents": 28800,
            "quarterly_price_cents": null,
            "currency": "USD",
            "discontinued": false,
            "tiers": [],
            "annual_tiers": [],
            "quarterly_tiers": [],
            "biannual_tiers": [],
            "upgrades": [
              "ultimate"
            ],
            "downgrades": [
              "new_essential"
            ],
            "features": {},
            "buyable": true,
            "trialable": false
          }
        ]
      },
      "plan_type": "ultimate",
      "payment_method_id": 1,
      "seats": 1,
      "seats_used": 1,
      "seats_pending": 1,
      "trial_plan_ends_at": null,
      "trial_plan_type": null,
      "trial_plan_active": false,
      "active_products": {},
      "billing_group_admin": false,
      "billing_group_member": false,
      "billing_group_seats": null,
      "card_brand": null,
      "card_last4": null,
      "card_month": null,
      "card_year": null,
      "contract_date": null,
      "contract_seats": null,
      "contract_min_seats": null,
      "stripe_customer_id": "cus_MfjzMZLrVonbx9",
      "balance": "0.0"
    },
    "relationships": {
      "organization": {
        "data": {
          "type": "organizations",
          "id": "800"
        }
      },
      "billing_group_owner": {
        "meta": {
          "included": false
        }
      },
      "billing_group_members": {
        "meta": {
          "included": false
        }
      }
    }
  },
  "meta": {}
}

PATCH  /api/v2/organization_subscriptions/801

Headers
Accept: text/xml,application/xml,application/xhtml+xml,text/html;q=0.9,text/plain;q=0.8,image/png,*/*;q=0.5
Content-Type: application/vnd.api+json
Body
{
  "data": {
    "type": "organization_subscriptions",
    "attributes": {
      "active_products": {
        "hris_integration": {
          "id": "hris_200"
        }
      }
    }
  }
}
Responses200
Headers
Content-Type: application/vnd.api+json; charset=utf-8
Body
{
  "data": {
    "id": "801",
    "type": "organization_subscriptions",
    "attributes": {
      "billing_email": null,
      "billing_address": null,
      "subscription_state_id": null,
      "trial_ends_at": null,
      "subscription_started_at": null,
      "subscription_ended_at": null,
      "next_billing_cycle_at": null,
      "grace_period_ends_at": null,
      "plan_price": 39,
      "discount": null,
      "discount_expires_on": null,
      "plan_cycle": "month",
      "current_plan": {
        "id": "ultimate",
        "name": "Ultimate",
        "type": null,
        "monthly_price_cents": 3900,
        "yearly_price_cents": 38400,
        "quarterly_price_cents": null,
        "currency": "USD",
        "discontinued": false,
        "tiers": [],
        "annual_tiers": [],
        "quarterly_tiers": [],
        "biannual_tiers": [],
        "upgrades": [],
        "downgrades": [
          "new_essential",
          "professional"
        ],
        "active_products": [
          {
            "stripe_id": "addon_hris_200_monthly",
            "product_type": "hris_integration",
            "id": "hris_200",
            "pricing_type": "by_seat",
            "monthly_price_cents": 200,
            "yearly_price_cents": 2400,
            "quarterly_price_cents": 600,
            "biannual_price_cents": 4800,
            "cycle": "month",
            "currency": "USD",
            "quantity": null
          }
        ],
        "buyable_products": [],
        "features": {},
        "cycle_change_enabled": true,
        "cycle_change_error": null,
        "upgradeables": [],
        "downgradeables": [
          {
            "id": "new_essential",
            "name": "Essential",
            "type": null,
            "monthly_price_cents": 1100,
            "yearly_price_cents": 10800,
            "quarterly_price_cents": null,
            "currency": "USD",
            "discontinued": false,
            "tiers": [],
            "annual_tiers": [],
            "quarterly_tiers": [],
            "biannual_tiers": [],
            "upgrades": [
              "professional",
              "ultimate"
            ],
            "downgrades": [],
            "features": {},
            "buyable": true,
            "trialable": false
          },
          {
            "id": "professional",
            "name": "Professional",
            "type": null,
            "monthly_price_cents": 2800,
            "yearly_price_cents": 28800,
            "quarterly_price_cents": null,
            "currency": "USD",
            "discontinued": false,
            "tiers": [],
            "annual_tiers": [],
            "quarterly_tiers": [],
            "biannual_tiers": [],
            "upgrades": [
              "ultimate"
            ],
            "downgrades": [
              "new_essential"
            ],
            "features": {},
            "buyable": true,
            "trialable": false
          }
        ]
      },
      "plan_type": "ultimate",
      "payment_method_id": 1,
      "seats": 1,
      "seats_used": 1,
      "seats_pending": 1,
      "trial_plan_ends_at": null,
      "trial_plan_type": null,
      "trial_plan_active": false,
      "active_products": {
        "hris_integration": {
          "id": "hris_200"
        }
      },
      "billing_group_admin": false,
      "billing_group_member": false,
      "billing_group_seats": null,
      "card_brand": null,
      "card_last4": null,
      "card_month": null,
      "card_year": null,
      "contract_date": null,
      "contract_seats": null,
      "contract_min_seats": null,
      "stripe_customer_id": "cus_MfjzMZLrVonbx9",
      "balance": "0.0"
    },
    "relationships": {
      "organization": {
        "data": {
          "type": "organizations",
          "id": "801"
        }
      },
      "billing_group_owner": {
        "meta": {
          "included": false
        }
      },
      "billing_group_members": {
        "meta": {
          "included": false
        }
      }
    }
  },
  "meta": {}
}

PATCH  /api/v2/organization_subscriptions/802

Headers
Accept: text/xml,application/xml,application/xhtml+xml,text/html;q=0.9,text/plain;q=0.8,image/png,*/*;q=0.5
Content-Type: application/vnd.api+json
Body
{
  "data": {
    "type": "organization_subscriptions",
    "attributes": {
      "active_products": {}
    }
  }
}
Responses200
Headers
Content-Type: application/vnd.api+json; charset=utf-8
Body
{
  "data": {
    "id": "802",
    "type": "organization_subscriptions",
    "attributes": {
      "billing_email": null,
      "billing_address": null,
      "subscription_state_id": null,
      "trial_ends_at": null,
      "subscription_started_at": null,
      "subscription_ended_at": null,
      "next_billing_cycle_at": null,
      "grace_period_ends_at": null,
      "plan_price": 39,
      "discount": null,
      "discount_expires_on": null,
      "plan_cycle": "month",
      "current_plan": {
        "id": "ultimate",
        "name": "Ultimate",
        "type": null,
        "monthly_price_cents": 3900,
        "yearly_price_cents": 38400,
        "quarterly_price_cents": null,
        "currency": "USD",
        "discontinued": false,
        "tiers": [],
        "annual_tiers": [],
        "quarterly_tiers": [],
        "biannual_tiers": [],
        "upgrades": [],
        "downgrades": [
          "new_essential",
          "professional"
        ],
        "active_products": [],
        "buyable_products": [],
        "features": {},
        "cycle_change_enabled": true,
        "cycle_change_error": null,
        "upgradeables": [],
        "downgradeables": [
          {
            "id": "new_essential",
            "name": "Essential",
            "type": null,
            "monthly_price_cents": 1100,
            "yearly_price_cents": 10800,
            "quarterly_price_cents": null,
            "currency": "USD",
            "discontinued": false,
            "tiers": [],
            "annual_tiers": [],
            "quarterly_tiers": [],
            "biannual_tiers": [],
            "upgrades": [
              "professional",
              "ultimate"
            ],
            "downgrades": [],
            "features": {},
            "buyable": true,
            "trialable": false
          },
          {
            "id": "professional",
            "name": "Professional",
            "type": null,
            "monthly_price_cents": 2800,
            "yearly_price_cents": 28800,
            "quarterly_price_cents": null,
            "currency": "USD",
            "discontinued": false,
            "tiers": [],
            "annual_tiers": [],
            "quarterly_tiers": [],
            "biannual_tiers": [],
            "upgrades": [
              "ultimate"
            ],
            "downgrades": [
              "new_essential"
            ],
            "features": {},
            "buyable": true,
            "trialable": false
          }
        ]
      },
      "plan_type": "ultimate",
      "payment_method_id": 1,
      "seats": 1,
      "seats_used": 1,
      "seats_pending": 1,
      "trial_plan_ends_at": null,
      "trial_plan_type": null,
      "trial_plan_active": false,
      "active_products": {},
      "billing_group_admin": false,
      "billing_group_member": false,
      "billing_group_seats": null,
      "card_brand": null,
      "card_last4": null,
      "card_month": null,
      "card_year": null,
      "contract_date": null,
      "contract_seats": null,
      "contract_min_seats": null,
      "stripe_customer_id": "cus_MfjzMZLrVonbx9",
      "balance": "0.0"
    },
    "relationships": {
      "organization": {
        "data": {
          "type": "organizations",
          "id": "802"
        }
      },
      "billing_group_owner": {
        "meta": {
          "included": false
        }
      },
      "billing_group_members": {
        "meta": {
          "included": false
        }
      }
    }
  },
  "meta": {}
}

PATCH  /api/v2/organization_subscriptions/803

Headers
Accept: text/xml,application/xml,application/xhtml+xml,text/html;q=0.9,text/plain;q=0.8,image/png,*/*;q=0.5
Content-Type: application/vnd.api+json
Body
{
  "data": {
    "type": "organization_subscriptions",
    "attributes": {
      "seats": 5,
      "plan_cycle": "year"
    }
  }
}
Responses200
Headers
Content-Type: application/vnd.api+json; charset=utf-8
Body
{
  "data": {
    "id": "803",
    "type": "organization_subscriptions",
    "attributes": {
      "billing_email": null,
      "billing_address": null,
      "subscription_state_id": null,
      "trial_ends_at": null,
      "subscription_started_at": null,
      "subscription_ended_at": null,
      "next_billing_cycle_at": null,
      "grace_period_ends_at": null,
      "plan_price": 384,
      "discount": null,
      "discount_expires_on": null,
      "plan_cycle": "year",
      "current_plan": {
        "id": "ultimate",
        "name": "Ultimate",
        "type": null,
        "monthly_price_cents": 3900,
        "yearly_price_cents": 38400,
        "quarterly_price_cents": null,
        "currency": "USD",
        "discontinued": false,
        "tiers": [],
        "annual_tiers": [],
        "quarterly_tiers": [],
        "biannual_tiers": [],
        "upgrades": [],
        "downgrades": [
          "new_essential",
          "professional"
        ],
        "active_products": [
          {
            "stripe_id": "addon_hris_2400_yearly",
            "product_type": "hris_integration",
            "id": "hris_200",
            "pricing_type": "by_seat",
            "monthly_price_cents": 200,
            "yearly_price_cents": 2400,
            "quarterly_price_cents": 600,
            "biannual_price_cents": 4800,
            "cycle": "year",
            "currency": "USD",
            "quantity": null
          }
        ],
        "buyable_products": [],
        "features": {},
        "cycle_change_enabled": true,
        "cycle_change_error": null,
        "upgradeables": [],
        "downgradeables": [
          {
            "id": "new_essential",
            "name": "Essential",
            "type": null,
            "monthly_price_cents": 1100,
            "yearly_price_cents": 10800,
            "quarterly_price_cents": null,
            "currency": "USD",
            "discontinued": false,
            "tiers": [],
            "annual_tiers": [],
            "quarterly_tiers": [],
            "biannual_tiers": [],
            "upgrades": [
              "professional",
              "ultimate"
            ],
            "downgrades": [],
            "features": {},
            "buyable": true,
            "trialable": false
          },
          {
            "id": "professional",
            "name": "Professional",
            "type": null,
            "monthly_price_cents": 2800,
            "yearly_price_cents": 28800,
            "quarterly_price_cents": null,
            "currency": "USD",
            "discontinued": false,
            "tiers": [],
            "annual_tiers": [],
            "quarterly_tiers": [],
            "biannual_tiers": [],
            "upgrades": [
              "ultimate"
            ],
            "downgrades": [
              "new_essential"
            ],
            "features": {},
            "buyable": true,
            "trialable": false
          }
        ]
      },
      "plan_type": "ultimate",
      "payment_method_id": 1,
      "seats": 5,
      "seats_used": 1,
      "seats_pending": 5,
      "trial_plan_ends_at": null,
      "trial_plan_type": null,
      "trial_plan_active": false,
      "active_products": {
        "hris_integration": {
          "id": "hris_200"
        }
      },
      "billing_group_admin": false,
      "billing_group_member": false,
      "billing_group_seats": null,
      "card_brand": null,
      "card_last4": null,
      "card_month": null,
      "card_year": null,
      "contract_date": null,
      "contract_seats": null,
      "contract_min_seats": null,
      "stripe_customer_id": "cus_MfjzMZLrVonbx9",
      "balance": "0.0"
    },
    "relationships": {
      "organization": {
        "data": {
          "type": "organizations",
          "id": "803"
        }
      },
      "billing_group_owner": {
        "meta": {
          "included": false
        }
      },
      "billing_group_members": {
        "meta": {
          "included": false
        }
      }
    }
  },
  "meta": {}
}

PATCH  /api/v2/organization_subscriptions/804

Headers
Accept: text/xml,application/xml,application/xhtml+xml,text/html;q=0.9,text/plain;q=0.8,image/png,*/*;q=0.5
Content-Type: application/vnd.api+json
Body
{
  "data": {
    "type": "organization_subscriptions",
    "attributes": {
      "stripe_token": "tok_u5dg20Gra",
      "seats": 3
    }
  }
}
Responses402
Headers
Content-Type: application/vnd.api+json; charset=utf-8
Body
{
  "errors": [
    {
      "status": 402,
      "title": "Stripe error",
      "detail": "The card was declined.",
      "source": {}
    }
  ]
}

PATCH  /api/v2/organization_subscriptions/815

Headers
Accept: text/xml,application/xml,application/xhtml+xml,text/html;q=0.9,text/plain;q=0.8,image/png,*/*;q=0.5
Content-Type: application/vnd.api+json
Body
{
  "data": {
    "type": "organization_subscriptions",
    "attributes": {
      "stripe_token": "tok_u5dg20Gra"
    }
  }
}
Responses422
Headers
Content-Type: application/vnd.api+json; charset=utf-8
Body
{
  "errors": [
    {
      "status": "422",
      "code": "invalid_attribute",
      "title": "Invalid Attribute",
      "detail": "can't be less than 3",
      "meta": {},
      "source": {
        "pointer": "data/attributes/seats"
      }
    },
    {
      "status": "422",
      "code": "invalid_attribute",
      "title": "Invalid Attribute",
      "detail": "can't be set to a legacy plan",
      "meta": {},
      "source": {
        "pointer": "data/attributes/plan_type"
      }
    }
  ]
}

PATCH  /api/v2/organization_subscriptions/816

Headers
Accept: text/xml,application/xml,application/xhtml+xml,text/html;q=0.9,text/plain;q=0.8,image/png,*/*;q=0.5
Content-Type: application/vnd.api+json
Body
{
  "data": {
    "type": "organization_subscriptions",
    "attributes": {
      "trial_plan_type": "professional"
    }
  }
}
Responses200
Headers
Content-Type: application/vnd.api+json; charset=utf-8
Body
{
  "data": {
    "id": "816",
    "type": "organization_subscriptions",
    "attributes": {
      "billing_email": null,
      "billing_address": null,
      "subscription_state_id": 2,
      "trial_ends_at": null,
      "subscription_started_at": null,
      "subscription_ended_at": null,
      "next_billing_cycle_at": null,
      "grace_period_ends_at": null,
      "plan_price": 15,
      "discount": null,
      "discount_expires_on": null,
      "plan_cycle": "month",
      "current_plan": {
        "id": "standard",
        "name": "Standard",
        "type": null,
        "monthly_price_cents": 1500,
        "yearly_price_cents": 15000,
        "quarterly_price_cents": null,
        "currency": "USD",
        "discontinued": true,
        "tiers": [],
        "annual_tiers": [],
        "quarterly_tiers": [],
        "biannual_tiers": [],
        "upgrades": [
          "new_essential",
          "professional",
          "ultimate"
        ],
        "downgrades": [],
        "active_products": [],
        "buyable_products": [],
        "features": {},
        "cycle_change_enabled": false,
        "cycle_change_error": "plan_discontinued",
        "upgradeables": [
          {
            "id": "new_essential",
            "name": "Essential",
            "type": null,
            "monthly_price_cents": 1100,
            "yearly_price_cents": 10800,
            "quarterly_price_cents": null,
            "currency": "USD",
            "discontinued": false,
            "tiers": [],
            "annual_tiers": [],
            "quarterly_tiers": [],
            "biannual_tiers": [],
            "upgrades": [
              "professional",
              "ultimate"
            ],
            "downgrades": [],
            "features": {},
            "buyable": true,
            "trialable": false
          },
          {
            "id": "professional",
            "name": "Professional",
            "type": null,
            "monthly_price_cents": 2800,
            "yearly_price_cents": 28800,
            "quarterly_price_cents": null,
            "currency": "USD",
            "discontinued": false,
            "tiers": [],
            "annual_tiers": [],
            "quarterly_tiers": [],
            "biannual_tiers": [],
            "upgrades": [
              "ultimate"
            ],
            "downgrades": [
              "new_essential"
            ],
            "features": {},
            "buyable": true,
            "trialable": false
          },
          {
            "id": "ultimate",
            "name": "Ultimate",
            "type": null,
            "monthly_price_cents": 3900,
            "yearly_price_cents": 38400,
            "quarterly_price_cents": null,
            "currency": "USD",
            "discontinued": false,
            "tiers": [],
            "annual_tiers": [],
            "quarterly_tiers": [],
            "biannual_tiers": [],
            "upgrades": [],
            "downgrades": [
              "new_essential",
              "professional"
            ],
            "features": {},
            "buyable": true,
            "trialable": false
          }
        ],
        "downgradeables": []
      },
      "plan_type": "standard",
      "payment_method_id": 1,
      "seats": 1,
      "seats_used": 1,
      "seats_pending": 1,
      "trial_plan_ends_at": "2019-01-15 23:59:59",
      "trial_plan_type": "professional",
      "trial_plan_active": true,
      "active_products": {},
      "billing_group_admin": false,
      "billing_group_member": false,
      "billing_group_seats": null,
      "card_brand": null,
      "card_last4": null,
      "card_month": null,
      "card_year": null,
      "contract_date": null,
      "contract_seats": null,
      "contract_min_seats": null,
      "stripe_customer_id": "cus_474RjipEtz2ff7",
      "balance": "0.0"
    },
    "relationships": {
      "organization": {
        "data": {
          "type": "organizations",
          "id": "816"
        }
      },
      "billing_group_owner": {
        "meta": {
          "included": false
        }
      },
      "billing_group_members": {
        "meta": {
          "included": false
        }
      }
    }
  },
  "meta": {}
}

PATCH  /api/v2/organization_subscriptions/817

Headers
Accept: text/xml,application/xml,application/xhtml+xml,text/html;q=0.9,text/plain;q=0.8,image/png,*/*;q=0.5
Content-Type: application/vnd.api+json
Body
{
  "data": {
    "type": "organization_subscriptions",
    "attributes": {
      "plan_cycle": "year",
      "stripe_token": "tok_u5dg20Gra"
    }
  }
}
Responses422
Headers
Content-Type: application/vnd.api+json; charset=utf-8
Body
{
  "errors": [
    {
      "status": "422",
      "code": "invalid_attribute",
      "title": "Invalid Attribute",
      "detail": "can't be less than 3",
      "meta": {},
      "source": {
        "pointer": "data/attributes/seats"
      }
    },
    {
      "status": "422",
      "code": "invalid_attribute",
      "title": "Invalid Attribute",
      "detail": "can't be changed on legacy plans",
      "meta": {},
      "source": {
        "pointer": "data/attributes/plan_cycle"
      }
    },
    {
      "status": "422",
      "code": "invalid_attribute",
      "title": "Invalid Attribute",
      "detail": "can't be set to a legacy plan",
      "meta": {},
      "source": {
        "pointer": "data/attributes/plan_type"
      }
    }
  ]
}

PATCH  /api/v2/organization_subscriptions/818

Headers
Accept: text/xml,application/xml,application/xhtml+xml,text/html;q=0.9,text/plain;q=0.8,image/png,*/*;q=0.5
Content-Type: application/vnd.api+json
Body
{
  "data": {
    "type": "organization_subscriptions",
    "attributes": {
      "plan_type": "ultimate"
    }
  }
}
Responses200
Headers
Content-Type: application/vnd.api+json; charset=utf-8
Body
{
  "data": {
    "id": "818",
    "type": "organization_subscriptions",
    "attributes": {
      "billing_email": null,
      "billing_address": null,
      "subscription_state_id": null,
      "trial_ends_at": null,
      "subscription_started_at": null,
      "subscription_ended_at": null,
      "next_billing_cycle_at": null,
      "grace_period_ends_at": null,
      "plan_price": 39,
      "discount": null,
      "discount_expires_on": null,
      "plan_cycle": "month",
      "current_plan": {
        "id": "ultimate",
        "name": "Ultimate",
        "type": null,
        "monthly_price_cents": 3900,
        "yearly_price_cents": 38400,
        "quarterly_price_cents": null,
        "currency": "USD",
        "discontinued": false,
        "tiers": [],
        "annual_tiers": [],
        "quarterly_tiers": [],
        "biannual_tiers": [],
        "upgrades": [],
        "downgrades": [
          "new_essential",
          "professional"
        ],
        "active_products": [],
        "buyable_products": [],
        "features": {},
        "cycle_change_enabled": true,
        "cycle_change_error": null,
        "upgradeables": [],
        "downgradeables": [
          {
            "id": "new_essential",
            "name": "Essential",
            "type": null,
            "monthly_price_cents": 1100,
            "yearly_price_cents": 10800,
            "quarterly_price_cents": null,
            "currency": "USD",
            "discontinued": false,
            "tiers": [],
            "annual_tiers": [],
            "quarterly_tiers": [],
            "biannual_tiers": [],
            "upgrades": [
              "professional",
              "ultimate"
            ],
            "downgrades": [],
            "features": {},
            "buyable": true,
            "trialable": false
          },
          {
            "id": "professional",
            "name": "Professional",
            "type": null,
            "monthly_price_cents": 2800,
            "yearly_price_cents": 28800,
            "quarterly_price_cents": null,
            "currency": "USD",
            "discontinued": false,
            "tiers": [],
            "annual_tiers": [],
            "quarterly_tiers": [],
            "biannual_tiers": [],
            "upgrades": [
              "ultimate"
            ],
            "downgrades": [
              "new_essential"
            ],
            "features": {},
            "buyable": true,
            "trialable": false
          }
        ]
      },
      "plan_type": "ultimate",
      "payment_method_id": 1,
      "seats": 1,
      "seats_used": 1,
      "seats_pending": 1,
      "trial_plan_ends_at": "2019-01-08 23:59:59",
      "trial_plan_type": "ultimate",
      "trial_plan_active": true,
      "active_products": {},
      "billing_group_admin": false,
      "billing_group_member": false,
      "billing_group_seats": null,
      "card_brand": null,
      "card_last4": null,
      "card_month": null,
      "card_year": null,
      "contract_date": null,
      "contract_seats": null,
      "contract_min_seats": null,
      "stripe_customer_id": "cus_474RjipEtz2ff7",
      "balance": "0.0"
    },
    "relationships": {
      "organization": {
        "data": {
          "type": "organizations",
          "id": "818"
        }
      },
      "billing_group_owner": {
        "meta": {
          "included": false
        }
      },
      "billing_group_members": {
        "meta": {
          "included": false
        }
      }
    }
  },
  "meta": {}
}

PATCH  /api/v2/organization_subscriptions/819

Headers
Accept: text/xml,application/xml,application/xhtml+xml,text/html;q=0.9,text/plain;q=0.8,image/png,*/*;q=0.5
Content-Type: application/vnd.api+json
Body
{
  "data": {
    "type": "organization_subscriptions",
    "attributes": {
      "trial_plan_type": null
    }
  }
}
Responses200
Headers
Content-Type: application/vnd.api+json; charset=utf-8
Body
{
  "data": {
    "id": "819",
    "type": "organization_subscriptions",
    "attributes": {
      "billing_email": null,
      "billing_address": null,
      "subscription_state_id": null,
      "trial_ends_at": null,
      "subscription_started_at": null,
      "subscription_ended_at": null,
      "next_billing_cycle_at": null,
      "grace_period_ends_at": null,
      "plan_price": 150,
      "discount": null,
      "discount_expires_on": null,
      "plan_cycle": "year",
      "current_plan": {
        "id": "standard",
        "name": "Standard",
        "type": null,
        "monthly_price_cents": 1500,
        "yearly_price_cents": 15000,
        "quarterly_price_cents": null,
        "currency": "USD",
        "discontinued": true,
        "tiers": [],
        "annual_tiers": [],
        "quarterly_tiers": [],
        "biannual_tiers": [],
        "upgrades": [
          "new_essential",
          "professional",
          "ultimate"
        ],
        "downgrades": [],
        "active_products": [],
        "buyable_products": [],
        "features": {},
        "cycle_change_enabled": false,
        "cycle_change_error": "plan_discontinued",
        "upgradeables": [
          {
            "id": "new_essential",
            "name": "Essential",
            "type": null,
            "monthly_price_cents": 1100,
            "yearly_price_cents": 10800,
            "quarterly_price_cents": null,
            "currency": "USD",
            "discontinued": false,
            "tiers": [],
            "annual_tiers": [],
            "quarterly_tiers": [],
            "biannual_tiers": [],
            "upgrades": [
              "professional",
              "ultimate"
            ],
            "downgrades": [],
            "features": {},
            "buyable": true,
            "trialable": false
          },
          {
            "id": "professional",
            "name": "Professional",
            "type": null,
            "monthly_price_cents": 2800,
            "yearly_price_cents": 28800,
            "quarterly_price_cents": null,
            "currency": "USD",
            "discontinued": false,
            "tiers": [],
            "annual_tiers": [],
            "quarterly_tiers": [],
            "biannual_tiers": [],
            "upgrades": [
              "ultimate"
            ],
            "downgrades": [
              "new_essential"
            ],
            "features": {},
            "buyable": true,
            "trialable": false
          },
          {
            "id": "ultimate",
            "name": "Ultimate",
            "type": null,
            "monthly_price_cents": 3900,
            "yearly_price_cents": 38400,
            "quarterly_price_cents": null,
            "currency": "USD",
            "discontinued": false,
            "tiers": [],
            "annual_tiers": [],
            "quarterly_tiers": [],
            "biannual_tiers": [],
            "upgrades": [],
            "downgrades": [
              "new_essential",
              "professional"
            ],
            "features": {},
            "buyable": true,
            "trialable": false
          }
        ],
        "downgradeables": []
      },
      "plan_type": "standard",
      "payment_method_id": 1,
      "seats": 1,
      "seats_used": 1,
      "seats_pending": 1,
      "trial_plan_ends_at": "2019-01-08 23:59:59",
      "trial_plan_type": null,
      "trial_plan_active": true,
      "active_products": {},
      "billing_group_admin": false,
      "billing_group_member": false,
      "billing_group_seats": null,
      "card_brand": null,
      "card_last4": null,
      "card_month": null,
      "card_year": null,
      "contract_date": null,
      "contract_seats": null,
      "contract_min_seats": null,
      "stripe_customer_id": "cus_474RjipEtz2ff7",
      "balance": "0.0"
    },
    "relationships": {
      "organization": {
        "data": {
          "type": "organizations",
          "id": "819"
        }
      },
      "billing_group_owner": {
        "meta": {
          "included": false
        }
      },
      "billing_group_members": {
        "meta": {
          "included": false
        }
      }
    }
  },
  "meta": {}
}

PATCH  /api/v2/organization_subscriptions/820

Headers
Accept: text/xml,application/xml,application/xhtml+xml,text/html;q=0.9,text/plain;q=0.8,image/png,*/*;q=0.5
Content-Type: application/vnd.api+json
Body
{
  "data": {
    "type": "organization_subscriptions",
    "attributes": {
      "plan_cycle": "year"
    }
  }
}
Responses422
Headers
Content-Type: application/vnd.api+json; charset=utf-8
Body
{
  "errors": [
    {
      "status": "422",
      "code": "invalid_attribute",
      "title": "Invalid Attribute",
      "detail": "can't be changed on legacy plans",
      "meta": {},
      "source": {
        "pointer": "data/attributes/plan_cycle"
      }
    }
  ]
}

PATCH  /api/v2/organization_subscriptions/821

Headers
Accept: text/xml,application/xml,application/xhtml+xml,text/html;q=0.9,text/plain;q=0.8,image/png,*/*;q=0.5
Content-Type: application/vnd.api+json
Body
{
  "data": {
    "type": "organization_subscriptions",
    "attributes": {
      "plan_type": "premium"
    }
  }
}
Responses422
Headers
Content-Type: application/vnd.api+json; charset=utf-8
Body
{
  "errors": [
    {
      "status": "422",
      "code": "invalid_attribute",
      "title": "Invalid Attribute",
      "detail": "invalid plan type",
      "meta": {},
      "source": {
        "pointer": "data/attributes/plan_type"
      }
    }
  ]
}

PATCH  /api/v2/organization_subscriptions/822

Headers
Accept: text/xml,application/xml,application/xhtml+xml,text/html;q=0.9,text/plain;q=0.8,image/png,*/*;q=0.5
Content-Type: application/vnd.api+json
Body
{
  "data": {
    "type": "organization_subscriptions",
    "attributes": {
      "plan_type": "premium_2025"
    }
  }
}
Responses422
Headers
Content-Type: application/vnd.api+json; charset=utf-8
Body
{
  "errors": [
    {
      "status": "422",
      "code": "invalid_attribute",
      "title": "Invalid Attribute",
      "detail": "invalid plan type",
      "meta": {},
      "source": {
        "pointer": "data/attributes/plan_type"
      }
    }
  ]
}

PATCH  /api/v2/organization_subscriptions/823

Headers
Accept: text/xml,application/xml,application/xhtml+xml,text/html;q=0.9,text/plain;q=0.8,image/png,*/*;q=0.5
Content-Type: application/vnd.api+json
Body
{
  "data": {
    "type": "organization_subscriptions",
    "attributes": {
      "plan_type": "standard"
    }
  }
}
Responses422
Headers
Content-Type: application/vnd.api+json; charset=utf-8
Body
{
  "errors": [
    {
      "status": "422",
      "code": "invalid_attribute",
      "title": "Invalid Attribute",
      "detail": "invalid plan type",
      "meta": {},
      "source": {
        "pointer": "data/attributes/plan_type"
      }
    }
  ]
}

PATCH  /api/v2/organization_subscriptions/824

Headers
Accept: text/xml,application/xml,application/xhtml+xml,text/html;q=0.9,text/plain;q=0.8,image/png,*/*;q=0.5
Content-Type: application/vnd.api+json
Body
{
  "data": {
    "type": "organization_subscriptions",
    "attributes": {
      "plan_type": "ultimate"
    }
  }
}
Responses200
Headers
Content-Type: application/vnd.api+json; charset=utf-8
Body
{
  "data": {
    "id": "824",
    "type": "organization_subscriptions",
    "attributes": {
      "billing_email": null,
      "billing_address": null,
      "subscription_state_id": null,
      "trial_ends_at": null,
      "subscription_started_at": null,
      "subscription_ended_at": null,
      "next_billing_cycle_at": null,
      "grace_period_ends_at": null,
      "plan_price": 39,
      "discount": null,
      "discount_expires_on": null,
      "plan_cycle": "month",
      "current_plan": {
        "id": "ultimate",
        "name": "Ultimate",
        "type": null,
        "monthly_price_cents": 3900,
        "yearly_price_cents": 38400,
        "quarterly_price_cents": null,
        "currency": "USD",
        "discontinued": false,
        "tiers": [],
        "annual_tiers": [],
        "quarterly_tiers": [],
        "biannual_tiers": [],
        "upgrades": [],
        "downgrades": [
          "new_essential",
          "professional"
        ],
        "active_products": [],
        "buyable_products": [],
        "features": {},
        "cycle_change_enabled": true,
        "cycle_change_error": null,
        "upgradeables": [],
        "downgradeables": [
          {
            "id": "new_essential",
            "name": "Essential",
            "type": null,
            "monthly_price_cents": 1100,
            "yearly_price_cents": 10800,
            "quarterly_price_cents": null,
            "currency": "USD",
            "discontinued": false,
            "tiers": [],
            "annual_tiers": [],
            "quarterly_tiers": [],
            "biannual_tiers": [],
            "upgrades": [
              "professional",
              "ultimate"
            ],
            "downgrades": [],
            "features": {},
            "buyable": true,
            "trialable": false
          },
          {
            "id": "professional",
            "name": "Professional",
            "type": null,
            "monthly_price_cents": 2800,
            "yearly_price_cents": 28800,
            "quarterly_price_cents": null,
            "currency": "USD",
            "discontinued": false,
            "tiers": [],
            "annual_tiers": [],
            "quarterly_tiers": [],
            "biannual_tiers": [],
            "upgrades": [
              "ultimate"
            ],
            "downgrades": [
              "new_essential"
            ],
            "features": {},
            "buyable": true,
            "trialable": false
          }
        ]
      },
      "plan_type": "ultimate",
      "payment_method_id": 1,
      "seats": 1,
      "seats_used": 1,
      "seats_pending": 1,
      "trial_plan_ends_at": null,
      "trial_plan_type": null,
      "trial_plan_active": false,
      "active_products": {},
      "billing_group_admin": false,
      "billing_group_member": false,
      "billing_group_seats": null,
      "card_brand": null,
      "card_last4": null,
      "card_month": null,
      "card_year": null,
      "contract_date": null,
      "contract_seats": null,
      "contract_min_seats": null,
      "stripe_customer_id": "cus_474RjipEtz2ff7",
      "balance": "0.0"
    },
    "relationships": {
      "organization": {
        "data": {
          "type": "organizations",
          "id": "824"
        }
      },
      "billing_group_owner": {
        "meta": {
          "included": false
        }
      },
      "billing_group_members": {
        "meta": {
          "included": false
        }
      }
    }
  },
  "meta": {}
}

PATCH  /api/v2/organization_subscriptions/825

Headers
Accept: text/xml,application/xml,application/xhtml+xml,text/html;q=0.9,text/plain;q=0.8,image/png,*/*;q=0.5
Content-Type: application/vnd.api+json
Body
{
  "data": {
    "type": "organization_subscriptions",
    "attributes": {
      "plan_type": "standard",
      "plan_cycle": "month"
    }
  }
}
Responses422
Headers
Content-Type: application/vnd.api+json; charset=utf-8
Body
{
  "errors": [
    {
      "status": "422",
      "code": "invalid_attribute",
      "title": "Invalid Attribute",
      "detail": "invalid plan type",
      "meta": {},
      "source": {
        "pointer": "data/attributes/plan_type"
      }
    },
    {
      "status": "422",
      "code": "invalid_attribute",
      "title": "Invalid Attribute",
      "detail": "can't be changed on legacy plans",
      "meta": {},
      "source": {
        "pointer": "data/attributes/plan_cycle"
      }
    }
  ]
}

PATCH  /api/v2/organization_subscriptions/826

Headers
Accept: text/xml,application/xml,application/xhtml+xml,text/html;q=0.9,text/plain;q=0.8,image/png,*/*;q=0.5
Content-Type: application/vnd.api+json
Body
{
  "data": {
    "type": "organization_subscriptions",
    "attributes": {
      "plan_cycle": "month"
    }
  }
}
Responses200
Headers
Content-Type: application/vnd.api+json; charset=utf-8
Body
{
  "data": {
    "id": "826",
    "type": "organization_subscriptions",
    "attributes": {
      "billing_email": null,
      "billing_address": null,
      "subscription_state_id": null,
      "trial_ends_at": null,
      "subscription_started_at": null,
      "subscription_ended_at": null,
      "next_billing_cycle_at": null,
      "grace_period_ends_at": null,
      "plan_price": 24,
      "discount": null,
      "discount_expires_on": null,
      "plan_cycle": "month",
      "current_plan": {
        "id": "premium",
        "name": "Premium",
        "type": null,
        "monthly_price_cents": 2400,
        "yearly_price_cents": 24000,
        "quarterly_price_cents": null,
        "currency": "USD",
        "discontinued": true,
        "tiers": [],
        "annual_tiers": [],
        "quarterly_tiers": [],
        "biannual_tiers": [],
        "upgrades": [
          "ultimate"
        ],
        "downgrades": [],
        "active_products": [],
        "buyable_products": [],
        "features": {},
        "cycle_change_enabled": false,
        "cycle_change_error": "plan_discontinued",
        "upgradeables": [
          {
            "id": "ultimate",
            "name": "Ultimate",
            "type": null,
            "monthly_price_cents": 3900,
            "yearly_price_cents": 38400,
            "quarterly_price_cents": null,
            "currency": "USD",
            "discontinued": false,
            "tiers": [],
            "annual_tiers": [],
            "quarterly_tiers": [],
            "biannual_tiers": [],
            "upgrades": [],
            "downgrades": [
              "new_essential",
              "professional"
            ],
            "features": {},
            "buyable": true,
            "trialable": false
          }
        ],
        "downgradeables": []
      },
      "plan_type": "premium",
      "payment_method_id": 1,
      "seats": 1,
      "seats_used": 1,
      "seats_pending": 1,
      "trial_plan_ends_at": null,
      "trial_plan_type": null,
      "trial_plan_active": false,
      "active_products": {},
      "billing_group_admin": false,
      "billing_group_member": false,
      "billing_group_seats": null,
      "card_brand": null,
      "card_last4": null,
      "card_month": null,
      "card_year": null,
      "contract_date": null,
      "contract_seats": null,
      "contract_min_seats": null,
      "stripe_customer_id": "cus_474RjipEtz2ff7",
      "balance": "0.0"
    },
    "relationships": {
      "organization": {
        "data": {
          "type": "organizations",
          "id": "826"
        }
      },
      "billing_group_owner": {
        "meta": {
          "included": false
        }
      },
      "billing_group_members": {
        "meta": {
          "included": false
        }
      }
    }
  },
  "meta": {}
}

Update a organization subscription
PATCH/api/v2/organization_subscriptions/{id}

URI Parameters
HideShow
id
number (required) Example: 1

organization subscription id

PATCH /api/v2/organization_subscriptions/1/cancel
Requestscancels subscription and tracks planhat activityreturns error and does not track planhat activitycancels subscriptionreturns error

PATCH  /api/v2/organization_subscriptions/807/cancel

Headers
Accept: text/xml,application/xml,application/xhtml+xml,text/html;q=0.9,text/plain;q=0.8,image/png,*/*;q=0.5
Content-Type: application/vnd.api+json
Body
{
  "data": {
    "type": "organization_subscriptions",
    "attributes": {
      "deactivation_reason_id": 2,
      "deactivation_note": "Why I quit Productive"
    }
  }
}
Responses200
Headers
Content-Type: application/vnd.api+json; charset=utf-8
Body
{
  "data": {
    "id": "807",
    "type": "organization_subscriptions",
    "attributes": {
      "billing_email": null,
      "billing_address": null,
      "subscription_state_id": 6,
      "trial_ends_at": null,
      "subscription_started_at": "2019-01-01T12:00:00.000+01:00",
      "subscription_ended_at": null,
      "next_billing_cycle_at": "2023-10-31 23:59:59",
      "grace_period_ends_at": null,
      "plan_price": 39,
      "discount": null,
      "discount_expires_on": null,
      "plan_cycle": "month",
      "current_plan": {
        "id": "ultimate",
        "name": "Ultimate",
        "type": null,
        "monthly_price_cents": 3900,
        "yearly_price_cents": 38400,
        "quarterly_price_cents": null,
        "currency": "USD",
        "discontinued": false,
        "tiers": [],
        "annual_tiers": [],
        "quarterly_tiers": [],
        "biannual_tiers": [],
        "upgrades": [],
        "downgrades": [
          "new_essential",
          "professional"
        ],
        "active_products": [],
        "buyable_products": [],
        "features": {},
        "cycle_change_enabled": true,
        "cycle_change_error": null,
        "upgradeables": [],
        "downgradeables": [
          {
            "id": "new_essential",
            "name": "Essential",
            "type": null,
            "monthly_price_cents": 1100,
            "yearly_price_cents": 10800,
            "quarterly_price_cents": null,
            "currency": "USD",
            "discontinued": false,
            "tiers": [],
            "annual_tiers": [],
            "quarterly_tiers": [],
            "biannual_tiers": [],
            "upgrades": [
              "professional",
              "ultimate"
            ],
            "downgrades": [],
            "features": {},
            "buyable": true,
            "trialable": false
          },
          {
            "id": "professional",
            "name": "Professional",
            "type": null,
            "monthly_price_cents": 2800,
            "yearly_price_cents": 28800,
            "quarterly_price_cents": null,
            "currency": "USD",
            "discontinued": false,
            "tiers": [],
            "annual_tiers": [],
            "quarterly_tiers": [],
            "biannual_tiers": [],
            "upgrades": [
              "ultimate"
            ],
            "downgrades": [
              "new_essential"
            ],
            "features": {},
            "buyable": true,
            "trialable": false
          }
        ]
      },
      "plan_type": "ultimate",
      "payment_method_id": 1,
      "seats": 1,
      "seats_used": 1,
      "seats_pending": 1,
      "trial_plan_ends_at": null,
      "trial_plan_type": null,
      "trial_plan_active": false,
      "active_products": {},
      "billing_group_admin": false,
      "billing_group_member": false,
      "billing_group_seats": null,
      "card_brand": null,
      "card_last4": null,
      "card_month": null,
      "card_year": null,
      "contract_date": null,
      "contract_seats": null,
      "contract_min_seats": null,
      "stripe_customer_id": "cus_MfjzMZLrVonbx9",
      "balance": "0.0"
    },
    "relationships": {
      "organization": {
        "data": {
          "type": "organizations",
          "id": "807"
        }
      },
      "billing_group_owner": {
        "meta": {
          "included": false
        }
      },
      "billing_group_members": {
        "meta": {
          "included": false
        }
      }
    }
  },
  "meta": {}
}

PATCH  /api/v2/organization_subscriptions/808/cancel

Headers
Accept: text/xml,application/xml,application/xhtml+xml,text/html;q=0.9,text/plain;q=0.8,image/png,*/*;q=0.5
Content-Type: application/vnd.api+json
Body
{
  "data": {
    "type": "organization_subscriptions",
    "attributes": {
      "deactivation_reason_id": 2,
      "deactivation_note": "Why I quit Productive"
    }
  }
}
Responses503
Headers
Content-Type: application/vnd.api+json; charset=utf-8
Body
{
  "errors": [
    {
      "status": 503,
      "title": "Stripe error",
      "detail": "A temporary problem with Stripe's servers.",
      "source": {}
    }
  ]
}

PATCH  /api/v2/organization_subscriptions/828/cancel

Headers
Accept: text/xml,application/xml,application/xhtml+xml,text/html;q=0.9,text/plain;q=0.8,image/png,*/*;q=0.5
Content-Type: application/vnd.api+json
Body
{
  "data": {
    "type": "organization_subscriptions",
    "attributes": {
      "deactivation_reason_id": 2,
      "deactivation_note": "Why I quit Productive"
    }
  }
}
Responses200
Headers
Content-Type: application/vnd.api+json; charset=utf-8
Body
{
  "data": {
    "id": "828",
    "type": "organization_subscriptions",
    "attributes": {
      "billing_email": null,
      "billing_address": null,
      "subscription_state_id": 6,
      "trial_ends_at": null,
      "subscription_started_at": "2019-01-01T12:00:00.000+01:00",
      "subscription_ended_at": null,
      "next_billing_cycle_at": "2015-10-15 23:59:59",
      "grace_period_ends_at": null,
      "plan_price": 24,
      "discount": null,
      "discount_expires_on": null,
      "plan_cycle": "month",
      "current_plan": {
        "id": "premium",
        "name": "Premium",
        "type": null,
        "monthly_price_cents": 2400,
        "yearly_price_cents": 24000,
        "quarterly_price_cents": null,
        "currency": "USD",
        "discontinued": true,
        "tiers": [],
        "annual_tiers": [],
        "quarterly_tiers": [],
        "biannual_tiers": [],
        "upgrades": [
          "ultimate"
        ],
        "downgrades": [],
        "active_products": [],
        "buyable_products": [],
        "features": {},
        "cycle_change_enabled": false,
        "cycle_change_error": "plan_discontinued",
        "upgradeables": [
          {
            "id": "ultimate",
            "name": "Ultimate",
            "type": null,
            "monthly_price_cents": 3900,
            "yearly_price_cents": 38400,
            "quarterly_price_cents": null,
            "currency": "USD",
            "discontinued": false,
            "tiers": [],
            "annual_tiers": [],
            "quarterly_tiers": [],
            "biannual_tiers": [],
            "upgrades": [],
            "downgrades": [
              "new_essential",
              "professional"
            ],
            "features": {},
            "buyable": true,
            "trialable": false
          }
        ],
        "downgradeables": []
      },
      "plan_type": "premium",
      "payment_method_id": 1,
      "seats": 1,
      "seats_used": 1,
      "seats_pending": 1,
      "trial_plan_ends_at": null,
      "trial_plan_type": null,
      "trial_plan_active": false,
      "active_products": {},
      "billing_group_admin": false,
      "billing_group_member": false,
      "billing_group_seats": null,
      "card_brand": null,
      "card_last4": null,
      "card_month": null,
      "card_year": null,
      "contract_date": null,
      "contract_seats": null,
      "contract_min_seats": null,
      "stripe_customer_id": "cus_474RjipEtz2ff7",
      "balance": "0.0"
    },
    "relationships": {
      "organization": {
        "data": {
          "type": "organizations",
          "id": "828"
        }
      },
      "billing_group_owner": {
        "meta": {
          "included": false
        }
      },
      "billing_group_members": {
        "meta": {
          "included": false
        }
      }
    }
  },
  "meta": {}
}

PATCH  /api/v2/organization_subscriptions/829/cancel

Headers
Accept: text/xml,application/xml,application/xhtml+xml,text/html;q=0.9,text/plain;q=0.8,image/png,*/*;q=0.5
Content-Type: application/vnd.api+json
Body
{
  "data": {
    "type": "organization_subscriptions",
    "attributes": {
      "deactivation_reason_id": 2,
      "deactivation_note": "Why I quit Productive"
    }
  }
}
Responses503
Headers
Content-Type: application/vnd.api+json; charset=utf-8
Body
{
  "errors": [
    {
      "status": 503,
      "title": "Stripe error",
      "detail": "A temporary problem with Stripe's servers.",
      "source": {}
    }
  ]
}

Cancels a organization subscription
PATCH/api/v2/organization_subscriptions/{id}/cancel

URI Parameters
HideShow
id
number (required) Example: 1

organization subscription id

PATCH /api/v2/organization_subscriptions/1/reactivate
Requestsreactivates subscription and tracks planhat activityreturns error and does not track planhat activitydoesn't reactivate subscriptionreturns error

PATCH  /api/v2/organization_subscriptions/809/reactivate

Headers
Accept: text/xml,application/xml,application/xhtml+xml,text/html;q=0.9,text/plain;q=0.8,image/png,*/*;q=0.5
Content-Type: application/vnd.api+json
Responses200
Headers
Content-Type: application/vnd.api+json; charset=utf-8
Body
{
  "data": {
    "id": "809",
    "type": "organization_subscriptions",
    "attributes": {
      "billing_email": null,
      "billing_address": null,
      "subscription_state_id": 2,
      "trial_ends_at": null,
      "subscription_started_at": "2019-01-01T12:00:00.000+01:00",
      "subscription_ended_at": null,
      "next_billing_cycle_at": "2023-10-31 23:59:59",
      "grace_period_ends_at": null,
      "plan_price": 39,
      "discount": null,
      "discount_expires_on": null,
      "plan_cycle": "month",
      "current_plan": {
        "id": "ultimate",
        "name": "Ultimate",
        "type": null,
        "monthly_price_cents": 3900,
        "yearly_price_cents": 38400,
        "quarterly_price_cents": null,
        "currency": "USD",
        "discontinued": false,
        "tiers": [],
        "annual_tiers": [],
        "quarterly_tiers": [],
        "biannual_tiers": [],
        "upgrades": [],
        "downgrades": [
          "new_essential",
          "professional"
        ],
        "active_products": [],
        "buyable_products": [],
        "features": {},
        "cycle_change_enabled": true,
        "cycle_change_error": null,
        "upgradeables": [],
        "downgradeables": [
          {
            "id": "new_essential",
            "name": "Essential",
            "type": null,
            "monthly_price_cents": 1100,
            "yearly_price_cents": 10800,
            "quarterly_price_cents": null,
            "currency": "USD",
            "discontinued": false,
            "tiers": [],
            "annual_tiers": [],
            "quarterly_tiers": [],
            "biannual_tiers": [],
            "upgrades": [
              "professional",
              "ultimate"
            ],
            "downgrades": [],
            "features": {},
            "buyable": true,
            "trialable": false
          },
          {
            "id": "professional",
            "name": "Professional",
            "type": null,
            "monthly_price_cents": 2800,
            "yearly_price_cents": 28800,
            "quarterly_price_cents": null,
            "currency": "USD",
            "discontinued": false,
            "tiers": [],
            "annual_tiers": [],
            "quarterly_tiers": [],
            "biannual_tiers": [],
            "upgrades": [
              "ultimate"
            ],
            "downgrades": [
              "new_essential"
            ],
            "features": {},
            "buyable": true,
            "trialable": false
          }
        ]
      },
      "plan_type": "ultimate",
      "payment_method_id": 1,
      "seats": 1,
      "seats_used": 1,
      "seats_pending": 1,
      "trial_plan_ends_at": null,
      "trial_plan_type": null,
      "trial_plan_active": false,
      "active_products": {},
      "billing_group_admin": false,
      "billing_group_member": false,
      "billing_group_seats": null,
      "card_brand": null,
      "card_last4": null,
      "card_month": null,
      "card_year": null,
      "contract_date": null,
      "contract_seats": null,
      "contract_min_seats": null,
      "stripe_customer_id": "cus_MfjzMZLrVonbx9",
      "balance": "0.0"
    },
    "relationships": {
      "organization": {
        "data": {
          "type": "organizations",
          "id": "809"
        }
      },
      "billing_group_owner": {
        "meta": {
          "included": false
        }
      },
      "billing_group_members": {
        "meta": {
          "included": false
        }
      }
    }
  },
  "meta": {}
}

PATCH  /api/v2/organization_subscriptions/810/reactivate

Headers
Accept: text/xml,application/xml,application/xhtml+xml,text/html;q=0.9,text/plain;q=0.8,image/png,*/*;q=0.5
Content-Type: application/vnd.api+json
Responses503
Headers
Content-Type: application/vnd.api+json; charset=utf-8
Body
{
  "errors": [
    {
      "status": 503,
      "title": "Stripe error",
      "detail": "A temporary problem with Stripe's servers.",
      "source": {}
    }
  ]
}

PATCH  /api/v2/organization_subscriptions/830/reactivate

Headers
Accept: text/xml,application/xml,application/xhtml+xml,text/html;q=0.9,text/plain;q=0.8,image/png,*/*;q=0.5
Content-Type: application/vnd.api+json
Responses405
Headers
Content-Type: application/vnd.api+json; charset=utf-8
Body
{
  "errors": [
    {
      "status": "405",
      "code": "reactivation_error",
      "title": "Reactivation error",
      "detail": "Can't reactivate subscription on a legacy plan",
      "source": {}
    }
  ]
}

PATCH  /api/v2/organization_subscriptions/831/reactivate

Headers
Accept: text/xml,application/xml,application/xhtml+xml,text/html;q=0.9,text/plain;q=0.8,image/png,*/*;q=0.5
Content-Type: application/vnd.api+json
Responses503
Headers
Content-Type: application/vnd.api+json; charset=utf-8
Body
{
  "errors": [
    {
      "status": 503,
      "title": "Stripe error",
      "detail": "A temporary problem with Stripe's servers.",
      "source": {}
    }
  ]
}

Reactivates a organization subscription
PATCH/api/v2/organization_subscriptions/{id}/reactivate

URI Parameters
HideShow
id
number (required) Example: 1

organization subscription id

PATCH /api/v2/organization_subscriptions/1/retry_last_payment
Requestsretries last invoice payment

PATCH  /api/v2/organization_subscriptions/811/retry_last_payment

Headers
Accept: text/xml,application/xml,application/xhtml+xml,text/html;q=0.9,text/plain;q=0.8,image/png,*/*;q=0.5
Content-Type: application/vnd.api+json
Responses200
Headers
Content-Type: application/vnd.api+json; charset=utf-8
Body
{
  "data": {
    "id": "811",
    "type": "organization_subscriptions",
    "attributes": {
      "billing_email": null,
      "billing_address": null,
      "subscription_state_id": null,
      "trial_ends_at": null,
      "subscription_started_at": null,
      "subscription_ended_at": null,
      "next_billing_cycle_at": null,
      "grace_period_ends_at": null,
      "plan_price": 39,
      "discount": null,
      "discount_expires_on": null,
      "plan_cycle": "month",
      "current_plan": {
        "id": "ultimate",
        "name": "Ultimate",
        "type": null,
        "monthly_price_cents": 3900,
        "yearly_price_cents": 38400,
        "quarterly_price_cents": null,
        "currency": "USD",
        "discontinued": false,
        "tiers": [],
        "annual_tiers": [],
        "quarterly_tiers": [],
        "biannual_tiers": [],
        "upgrades": [],
        "downgrades": [
          "new_essential",
          "professional"
        ],
        "active_products": [],
        "buyable_products": [],
        "features": {},
        "cycle_change_enabled": true,
        "cycle_change_error": null,
        "upgradeables": [],
        "downgradeables": [
          {
            "id": "new_essential",
            "name": "Essential",
            "type": null,
            "monthly_price_cents": 1100,
            "yearly_price_cents": 10800,
            "quarterly_price_cents": null,
            "currency": "USD",
            "discontinued": false,
            "tiers": [],
            "annual_tiers": [],
            "quarterly_tiers": [],
            "biannual_tiers": [],
            "upgrades": [
              "professional",
              "ultimate"
            ],
            "downgrades": [],
            "features": {},
            "buyable": true,
            "trialable": false
          },
          {
            "id": "professional",
            "name": "Professional",
            "type": null,
            "monthly_price_cents": 2800,
            "yearly_price_cents": 28800,
            "quarterly_price_cents": null,
            "currency": "USD",
            "discontinued": false,
            "tiers": [],
            "annual_tiers": [],
            "quarterly_tiers": [],
            "biannual_tiers": [],
            "upgrades": [
              "ultimate"
            ],
            "downgrades": [
              "new_essential"
            ],
            "features": {},
            "buyable": true,
            "trialable": false
          }
        ]
      },
      "plan_type": "ultimate",
      "payment_method_id": 1,
      "seats": 1,
      "seats_used": 1,
      "seats_pending": 1,
      "trial_plan_ends_at": null,
      "trial_plan_type": null,
      "trial_plan_active": false,
      "active_products": {},
      "billing_group_admin": false,
      "billing_group_member": false,
      "billing_group_seats": null,
      "card_brand": null,
      "card_last4": null,
      "card_month": null,
      "card_year": null,
      "contract_date": null,
      "contract_seats": null,
      "contract_min_seats": null,
      "stripe_customer_id": "cus_MfjzMZLrVonbx9",
      "balance": "0.0"
    },
    "relationships": {
      "organization": {
        "data": {
          "type": "organizations",
          "id": "811"
        }
      },
      "billing_group_owner": {
        "meta": {
          "included": false
        }
      },
      "billing_group_members": {
        "meta": {
          "included": false
        }
      }
    }
  },
  "meta": {}
}

Retry last payment for a organization subscription
PATCH/api/v2/organization_subscriptions/{id}/retry_last_payment

URI Parameters
HideShow
id
number (required) Example: 1

organization subscription id

Generated by aglio on 03 Feb 2026