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/754

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": "754",
    "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,
      "subscription_ends_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,
        "is_billable": true,
        "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,
            "is_billable": true,
            "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,
            "is_billable": true,
            "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": {},
      "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": "754"
        }
      },
      "active_plan": {
        "meta": {
          "included": false
        }
      }
    }
  },
  "meta": {}
}

GET  /api/v2/organization_subscriptions/776

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": "776",
    "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,
      "subscription_ends_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,
        "is_billable": true,
        "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,
            "is_billable": true,
            "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": {},
      "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": "776"
        }
      },
      "active_plan": {
        "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/755

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"
    }
  }
}
Responses200
Headers
Content-Type: application/vnd.api+json; charset=utf-8
Body
{
  "data": {
    "id": "755",
    "type": "organization_subscriptions",
    "attributes": {
      "billing_email": null,
      "billing_address": null,
      "subscription_state_id": 5,
      "trial_ends_at": null,
      "subscription_started_at": null,
      "subscription_ended_at": null,
      "subscription_ends_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,
        "is_billable": true,
        "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,
            "is_billable": true,
            "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,
            "is_billable": true,
            "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": {},
      "card_brand": "mastercard",
      "card_last4": "4141",
      "card_month": "11",
      "card_year": "2032",
      "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": "755"
        }
      },
      "active_plan": {
        "meta": {
          "included": false
        }
      }
    }
  },
  "meta": {}
}

PATCH  /api/v2/organization_subscriptions/756

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": "756",
    "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,
      "subscription_ends_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,
        "is_billable": true,
        "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,
            "is_billable": true,
            "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,
            "is_billable": true,
            "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": {},
      "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": "756"
        }
      },
      "active_plan": {
        "meta": {
          "included": false
        }
      }
    }
  },
  "meta": {}
}

PATCH  /api/v2/organization_subscriptions/757

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": "757",
    "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,
      "subscription_ends_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,
        "is_billable": true,
        "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,
            "is_billable": true,
            "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,
            "is_billable": true,
            "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": {},
      "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": "757"
        }
      },
      "active_plan": {
        "meta": {
          "included": false
        }
      }
    }
  },
  "meta": {}
}

PATCH  /api/v2/organization_subscriptions/758

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": "758",
    "type": "organization_subscriptions",
    "attributes": {
      "billing_email": null,
      "billing_address": null,
      "subscription_state_id": 5,
      "trial_ends_at": null,
      "subscription_started_at": null,
      "subscription_ended_at": null,
      "subscription_ends_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,
        "is_billable": true,
        "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,
            "is_billable": true,
            "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,
            "is_billable": true,
            "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": {},
      "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": "758"
        }
      },
      "active_plan": {
        "meta": {
          "included": false
        }
      }
    }
  },
  "meta": {}
}

PATCH  /api/v2/organization_subscriptions/759

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": "759",
    "type": "organization_subscriptions",
    "attributes": {
      "billing_email": null,
      "billing_address": null,
      "subscription_state_id": 5,
      "trial_ends_at": null,
      "subscription_started_at": null,
      "subscription_ended_at": null,
      "subscription_ends_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,
        "is_billable": true,
        "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,
            "is_billable": true,
            "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,
            "is_billable": true,
            "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": {},
      "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": "759"
        }
      },
      "active_plan": {
        "meta": {
          "included": false
        }
      }
    }
  },
  "meta": {}
}

PATCH  /api/v2/organization_subscriptions/760

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": "760",
    "type": "organization_subscriptions",
    "attributes": {
      "billing_email": null,
      "billing_address": null,
      "subscription_state_id": 5,
      "trial_ends_at": null,
      "subscription_started_at": null,
      "subscription_ended_at": null,
      "subscription_ends_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,
        "is_billable": true,
        "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,
            "is_billable": true,
            "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,
            "is_billable": true,
            "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": {},
      "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": "760"
        }
      },
      "active_plan": {
        "meta": {
          "included": false
        }
      }
    }
  },
  "meta": {}
}

PATCH  /api/v2/organization_subscriptions/761

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": "761",
    "type": "organization_subscriptions",
    "attributes": {
      "billing_email": null,
      "billing_address": null,
      "subscription_state_id": 5,
      "trial_ends_at": null,
      "subscription_started_at": null,
      "subscription_ended_at": null,
      "subscription_ends_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,
        "is_billable": true,
        "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,
            "is_billable": true,
            "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,
            "is_billable": true,
            "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": {},
      "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": "761"
        }
      },
      "active_plan": {
        "meta": {
          "included": false
        }
      }
    }
  },
  "meta": {}
}

PATCH  /api/v2/organization_subscriptions/762

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": "762",
    "type": "organization_subscriptions",
    "attributes": {
      "billing_email": null,
      "billing_address": null,
      "subscription_state_id": 5,
      "trial_ends_at": null,
      "subscription_started_at": null,
      "subscription_ended_at": null,
      "subscription_ends_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,
        "is_billable": true,
        "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,
            "is_billable": true,
            "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,
            "is_billable": true,
            "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": {},
      "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": "762"
        }
      },
      "active_plan": {
        "meta": {
          "included": false
        }
      }
    }
  },
  "meta": {}
}

PATCH  /api/v2/organization_subscriptions/763

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": "763",
    "type": "organization_subscriptions",
    "attributes": {
      "billing_email": null,
      "billing_address": null,
      "subscription_state_id": 5,
      "trial_ends_at": null,
      "subscription_started_at": null,
      "subscription_ended_at": null,
      "subscription_ends_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,
        "is_billable": true,
        "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,
            "is_billable": true,
            "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,
            "is_billable": true,
            "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": {},
      "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": "763"
        }
      },
      "active_plan": {
        "meta": {
          "included": false
        }
      }
    }
  },
  "meta": {}
}

PATCH  /api/v2/organization_subscriptions/764

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": "764",
    "type": "organization_subscriptions",
    "attributes": {
      "billing_email": null,
      "billing_address": null,
      "subscription_state_id": 5,
      "trial_ends_at": null,
      "subscription_started_at": null,
      "subscription_ended_at": null,
      "subscription_ends_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,
        "is_billable": true,
        "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,
            "is_billable": true,
            "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,
            "is_billable": true,
            "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": {},
      "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": "764"
        }
      },
      "active_plan": {
        "meta": {
          "included": false
        }
      }
    }
  },
  "meta": {}
}

PATCH  /api/v2/organization_subscriptions/765

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": "765",
    "type": "organization_subscriptions",
    "attributes": {
      "billing_email": null,
      "billing_address": null,
      "subscription_state_id": 5,
      "trial_ends_at": null,
      "subscription_started_at": null,
      "subscription_ended_at": null,
      "subscription_ends_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,
        "is_billable": true,
        "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,
            "is_billable": true,
            "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,
            "is_billable": true,
            "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"
        }
      },
      "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": "765"
        }
      },
      "active_plan": {
        "meta": {
          "included": false
        }
      }
    }
  },
  "meta": {}
}

PATCH  /api/v2/organization_subscriptions/766

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": "766",
    "type": "organization_subscriptions",
    "attributes": {
      "billing_email": null,
      "billing_address": null,
      "subscription_state_id": 5,
      "trial_ends_at": null,
      "subscription_started_at": null,
      "subscription_ended_at": null,
      "subscription_ends_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,
        "is_billable": true,
        "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,
            "is_billable": true,
            "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,
            "is_billable": true,
            "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": {},
      "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": "766"
        }
      },
      "active_plan": {
        "meta": {
          "included": false
        }
      }
    }
  },
  "meta": {}
}

PATCH  /api/v2/organization_subscriptions/767

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": "767",
    "type": "organization_subscriptions",
    "attributes": {
      "billing_email": null,
      "billing_address": null,
      "subscription_state_id": 5,
      "trial_ends_at": null,
      "subscription_started_at": null,
      "subscription_ended_at": null,
      "subscription_ends_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,
        "is_billable": true,
        "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,
            "is_billable": true,
            "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,
            "is_billable": true,
            "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"
        }
      },
      "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": "767"
        }
      },
      "active_plan": {
        "meta": {
          "included": false
        }
      }
    }
  },
  "meta": {}
}

PATCH  /api/v2/organization_subscriptions/768

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"
    }
  }
}
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/777

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 set to a legacy plan",
      "source": {
        "pointer": "data/attributes/plan_type"
      }
    }
  ]
}

PATCH  /api/v2/organization_subscriptions/778

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": "778",
    "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,
      "subscription_ends_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,
        "is_billable": true,
        "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,
            "is_billable": true,
            "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,
            "is_billable": true,
            "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,
            "is_billable": true,
            "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": {},
      "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": "778"
        }
      },
      "active_plan": {
        "meta": {
          "included": false
        }
      }
    }
  },
  "meta": {}
}

PATCH  /api/v2/organization_subscriptions/779

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 changed on legacy plans",
      "source": {
        "pointer": "data/attributes/plan_cycle"
      }
    },
    {
      "status": "422",
      "code": "invalid_attribute",
      "title": "Invalid Attribute",
      "detail": "can't be set to a legacy plan",
      "source": {
        "pointer": "data/attributes/plan_type"
      }
    }
  ]
}

PATCH  /api/v2/organization_subscriptions/780

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": "780",
    "type": "organization_subscriptions",
    "attributes": {
      "billing_email": null,
      "billing_address": null,
      "subscription_state_id": 5,
      "trial_ends_at": null,
      "subscription_started_at": null,
      "subscription_ended_at": null,
      "subscription_ends_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,
        "is_billable": true,
        "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,
            "is_billable": true,
            "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,
            "is_billable": true,
            "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": {},
      "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": "780"
        }
      },
      "active_plan": {
        "meta": {
          "included": false
        }
      }
    }
  },
  "meta": {}
}

PATCH  /api/v2/organization_subscriptions/781

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": "781",
    "type": "organization_subscriptions",
    "attributes": {
      "billing_email": null,
      "billing_address": null,
      "subscription_state_id": 5,
      "trial_ends_at": null,
      "subscription_started_at": null,
      "subscription_ended_at": null,
      "subscription_ends_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,
        "is_billable": true,
        "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,
            "is_billable": true,
            "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,
            "is_billable": true,
            "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,
            "is_billable": true,
            "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": {},
      "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": "781"
        }
      },
      "active_plan": {
        "meta": {
          "included": false
        }
      }
    }
  },
  "meta": {}
}

PATCH  /api/v2/organization_subscriptions/782

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",
      "source": {
        "pointer": "data/attributes/plan_cycle"
      }
    }
  ]
}

PATCH  /api/v2/organization_subscriptions/783

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": "attribute is invalid",
      "source": {
        "pointer": "data/attributes/plan_type"
      }
    }
  ]
}

PATCH  /api/v2/organization_subscriptions/784

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": "attribute is invalid",
      "source": {
        "pointer": "data/attributes/plan_type"
      }
    }
  ]
}

PATCH  /api/v2/organization_subscriptions/785

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": "attribute is invalid",
      "source": {
        "pointer": "data/attributes/plan_type"
      }
    }
  ]
}

PATCH  /api/v2/organization_subscriptions/786

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": "786",
    "type": "organization_subscriptions",
    "attributes": {
      "billing_email": null,
      "billing_address": null,
      "subscription_state_id": 5,
      "trial_ends_at": null,
      "subscription_started_at": null,
      "subscription_ended_at": null,
      "subscription_ends_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,
        "is_billable": true,
        "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,
            "is_billable": true,
            "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,
            "is_billable": true,
            "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": {},
      "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": "786"
        }
      },
      "active_plan": {
        "meta": {
          "included": false
        }
      }
    }
  },
  "meta": {}
}

PATCH  /api/v2/organization_subscriptions/787

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": "attribute is invalid",
      "source": {
        "pointer": "data/attributes/plan_type"
      }
    }
  ]
}

PATCH  /api/v2/organization_subscriptions/788

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": "788",
    "type": "organization_subscriptions",
    "attributes": {
      "billing_email": null,
      "billing_address": null,
      "subscription_state_id": 5,
      "trial_ends_at": null,
      "subscription_started_at": null,
      "subscription_ended_at": null,
      "subscription_ends_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,
        "is_billable": true,
        "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,
            "is_billable": true,
            "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": {},
      "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": "788"
        }
      },
      "active_plan": {
        "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 intercom eventreturns error and does not track intercom eventcancels subscriptionreturns error

PATCH  /api/v2/organization_subscriptions/771/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": "771",
    "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,
      "subscription_ends_at": "2023-10-31 23:59:59",
      "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,
        "is_billable": true,
        "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,
            "is_billable": true,
            "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,
            "is_billable": true,
            "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": 0,
      "trial_plan_ends_at": null,
      "trial_plan_type": null,
      "trial_plan_active": false,
      "active_products": {},
      "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": "771"
        }
      },
      "active_plan": {
        "meta": {
          "included": false
        }
      }
    }
  },
  "meta": {}
}

PATCH  /api/v2/organization_subscriptions/772/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/790/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": "790",
    "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,
      "subscription_ends_at": "2015-10-15 23:59:59",
      "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,
        "is_billable": true,
        "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,
            "is_billable": true,
            "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": {},
      "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": "790"
        }
      },
      "active_plan": {
        "meta": {
          "included": false
        }
      }
    }
  },
  "meta": {}
}

PATCH  /api/v2/organization_subscriptions/791/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 intercom eventreturns error and does not track intercom eventdoesn't reactivate subscriptionreturns error

PATCH  /api/v2/organization_subscriptions/773/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": "773",
    "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,
      "subscription_ends_at": "2023-10-31 23:59:59",
      "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,
        "is_billable": true,
        "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,
            "is_billable": true,
            "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,
            "is_billable": true,
            "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": 0,
      "trial_plan_ends_at": null,
      "trial_plan_type": null,
      "trial_plan_active": false,
      "active_products": {},
      "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": "773"
        }
      },
      "active_plan": {
        "meta": {
          "included": false
        }
      }
    }
  },
  "meta": {}
}

PATCH  /api/v2/organization_subscriptions/774/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/792/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/793/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/775/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": "775",
    "type": "organization_subscriptions",
    "attributes": {
      "billing_email": null,
      "billing_address": null,
      "subscription_state_id": 5,
      "trial_ends_at": null,
      "subscription_started_at": null,
      "subscription_ended_at": null,
      "subscription_ends_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,
        "is_billable": true,
        "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,
            "is_billable": true,
            "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,
            "is_billable": true,
            "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": {},
      "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": "775"
        }
      },
      "active_plan": {
        "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 02 Aug 2025