> ## Documentation Index
> Fetch the complete documentation index at: https://docs.instacloud.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Get plan change options

> **Token scope:** `account` · `org` — read-only tokens allowed.

Read paid-plan change availability, current subscription prices and an authorized pending retry



## OpenAPI

````yaml /openapi/org.json get /orgs/{orgId}/billing/plan-change
openapi: 3.1.0
info:
  title: InstaCloud API — Organization level
  version: 0.1.0
  description: >-
    Endpoints under `/orgs/{orgId}`: members, projects, billing, domains.
    Callable with an account-wide token or a token bound to that organization.


    Generated from the platform's own OpenAPI document
    (https://api.instacloud.com/openapi.json); see the [API
    overview](/reference/api/overview) for authentication and token scopes.
servers:
  - url: https://api.instacloud.com
    description: InstaCloud
security:
  - bearerAuth: []
tags:
  - name: Organization
    description: 'The organization itself: name, members, invitations.'
  - name: Projects
    description: Projects inside an organization.
  - name: Audit
    description: The project's event timeline, including agent-ingested events.
  - name: Domains
    description: >-
      Domains bought through InstaCloud, bring-your-own zones and their DNS
      records.
  - name: Billing
    description: Usage, cycles, invoices and credits.
  - name: Templates
    description: Deploy a template into a project.
paths:
  /orgs/{orgId}/billing/plan-change:
    get:
      tags:
        - Billing
      summary: Get plan change options
      description: >-
        **Token scope:** `account` · `org` — read-only tokens allowed.


        Read paid-plan change availability, current subscription prices and an
        authorized pending retry
      operationId: getPlanChangeOptions
      parameters:
        - schema:
            format: uuid
            type: string
          in: path
          name: orgId
          required: true
      responses:
        '200':
          description: Default Response
          content:
            application/json:
              schema:
                type: object
                properties:
                  enabled:
                    type: boolean
                  canManage:
                    type: boolean
                  pending:
                    type:
                      - object
                      - 'null'
                    properties:
                      id:
                        format: uuid
                        type: string
                      fromTier:
                        type: string
                      toTier:
                        type: string
                      status:
                        anyOf:
                          - type: string
                            enum:
                              - awaiting_payment
                          - type: string
                            enum:
                              - scheduled
                          - type: string
                            enum:
                              - applied
                          - type: string
                            enum:
                              - failed
                          - type: string
                            enum:
                              - cancelled
                      effectiveAt:
                        format: date-time
                        type: string
                      includedUsd:
                        type: number
                      changeKind:
                        anyOf:
                          - type: string
                            enum:
                              - upgrade
                          - type: string
                            enum:
                              - downgrade
                      renewalAt:
                        format: date-time
                        type: string
                      cancellable:
                        type: boolean
                      paymentUrl:
                        format: uri
                        type:
                          - string
                          - 'null'
                    required:
                      - id
                      - fromTier
                      - toTier
                      - status
                      - effectiveAt
                      - includedUsd
                  retryKey:
                    type:
                      - string
                      - 'null'
                  options:
                    type: array
                    items:
                      type: object
                      properties:
                        tier:
                          anyOf:
                            - type: string
                              enum:
                                - free
                            - type: string
                              enum:
                                - pro
                            - type: string
                              enum:
                                - team
                        feeCents:
                          minimum: 0
                          type: integer
                        currency:
                          type: string
                          enum:
                            - usd
                        includedUsd:
                          minimum: 0
                          type: number
                        effectiveAt:
                          format: date-time
                          type: string
                        renewalAt:
                          format: date-time
                          type: string
                        renewalFeeCents:
                          minimum: 0
                          type: integer
                        changeKind:
                          anyOf:
                            - type: string
                              enum:
                                - upgrade
                            - type: string
                              enum:
                                - downgrade
                      required:
                        - tier
                        - feeCents
                        - currency
                        - includedUsd
                required:
                  - enabled
                  - canManage
                  - pending
                  - retryKey
                  - options
        '403':
          description: Default Response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
        '404':
          description: Default Response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
        '503':
          description: Default Response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
components:
  schemas:
    Error:
      type: object
      properties:
        error:
          type: string
      required:
        - error
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      description: Session access JWT or an API token (`insta_<prefix>_<secret>`).

````