Get plan change options
GEThttps://api.instacloud.com/orgs/{orgId}/billing/plan-change
Token scope: account · org — read-only tokens allowed.
Read paid-plan change availability, current subscription prices and an authorized pending retry
Parameters
| Name | In | Type | Required | Description |
|---|---|---|---|---|
orgId | path | string | yes |
Responses
200
Default Response
| Field | Type | Required | Description |
|---|---|---|---|
enabled | boolean | yes | |
canManage | boolean | yes | |
pending | object | null | yes | |
pending.id | string | yes | |
pending.fromTier | string | yes | |
pending.toTier | string | yes | |
pending.status | "awaiting_payment" | "scheduled" | "applied" | "failed" | "cancelled" | yes | |
pending.effectiveAt | string | yes | |
pending.includedUsd | number | yes | |
pending.changeKind | "upgrade" | "downgrade" | no | |
pending.renewalAt | string | no | |
pending.cancellable | boolean | no | |
pending.paymentUrl | string | null | no | |
retryKey | string | null | yes | |
options | object[] | yes | |
options.tier | "free" | "pro" | "team" | yes | |
options.feeCents | integer | yes | |
options.currency | "usd" | yes | |
options.includedUsd | number | yes | |
options.effectiveAt | string | no | |
options.renewalAt | string | no | |
options.renewalFeeCents | integer | no | |
options.changeKind | "upgrade" | "downgrade" | no |
403
Default Response
| Field | Type | Required | Description |
|---|---|---|---|
error | string | yes |
404
Default Response
| Field | Type | Required | Description |
|---|---|---|---|
error | string | yes |
503
Default Response
| Field | Type | Required | Description |
|---|---|---|---|
error | string | yes |