List Subscription eligible transitions

GET /v1/customers/{customerId}/subscriptions/{subscriptionId}/eligible-transitions

Returns a list of eligible transitions for a specified subscription.

Headers

  • X-Tenant string Required

    The domain used to access the portal.

  • Authorization string Required

    JWT Authorization header using the Bearer scheme. Example: "Authorization: Bearer {token}"

    Default value is Bearer eyJ0eXAiO....

  • X-Correlation-Id string(UUID)

    This header is optional and by setting it you can correlate the audit logs made by this request.

Path parameters

  • customerId string(uuid) Required

    GUID Unique identifier for the customer. The subscription must belong to this customer, otherwise this request will fail.

  • subscriptionId string(uuid) Required

    GUID Unique identifier for the subscription.

Responses

  • OK

    Hide response attributes Show response attributes object
    • destinationSubscriptionId string(uuid) | null

      The destination subscription identifier.

    • The destination subscription provider identifer.

    • offerName string | null

      The name of the offer.

    • offerId string(uuid)

      The name of the offer.

    • providerOfferId string | null Required

      The provider offer identifier.

    • providerOfferIdWithAvailability string | null Required

      The provider offer identifier.

    • imageUrl string | null

      The offer image URL.

    • quantity integer(int32) Required

      The quantity.

    • termDuration object Required

      The term duration for this entity. Possible values: NoTerm, OneMonth, OneYear, ThreeYears or FiveYears

      Additional properties are NOT allowed.

      Hide termDuration attribute Show termDuration attribute object
      • name string | null

        The name of the enumeration.

    • billingFrequency object Required

      The billing frequency for this entity. Possible values: OneTime, Monthly, Annual, Triennial or None

      Additional properties are NOT allowed.

      Hide billingFrequency attribute Show billingFrequency attribute object
      • name string | null

        The name of the enumeration.

    • transitionType string | null Required

      The type of transition ('transition_only','transition_with_license_transfer').

    • transitionEvents array[object] | null

      A list with the events related to a transition.

      Hide transitionEvents attributes Show transitionEvents attributes object
      • name string | null

        The trasition event name.

      • status string | null

        The trasition event status.

  • Bad Request

    Hide response attributes Show response attributes object
    • statusCode integer(int32)

      The HTTP status code that represents a specific error scenario.

    • type string | null

      The type of error that occurred.

    • description string | null

      Describes the error scenario that occurred.

    • correlationId string | null

      The correlationId of the request that originated the error.

    • errors array[object] | null

      A list containing the detail of the errors that occurred in this error scenario.

      This class is used to represent the details of an error and specifies the name of the property and the description of each of the errors associated with that property.

      Hide errors attributes Show errors attributes object
      • propertyName string | null

        The name of the property involved in the error.

      • description array[string] | null

        A description of each error associated with the given property.

  • Unauthorized

  • Forbidden

  • Not Found

    Hide response attributes Show response attributes object
    • statusCode integer(int32)

      The HTTP status code that represents a specific error scenario.

    • type string | null

      The type of error that occurred.

    • description string | null

      Describes the error scenario that occurred.

    • correlationId string | null

      The correlationId of the request that originated the error.

    • errors array[object] | null

      A list containing the detail of the errors that occurred in this error scenario.

      This class is used to represent the details of an error and specifies the name of the property and the description of each of the errors associated with that property.

      Hide errors attributes Show errors attributes object
      • propertyName string | null

        The name of the property involved in the error.

      • description array[string] | null

        A description of each error associated with the given property.

  • Internal Server Error

    Hide response attributes Show response attributes object
    • statusCode integer(int32)

      The HTTP status code that represents a specific error scenario.

    • type string | null

      The type of error that occurred.

    • description string | null

      Describes the error scenario that occurred.

    • correlationId string | null

      The correlationId of the request that originated the error.

    • errors array[object] | null

      A list containing the detail of the errors that occurred in this error scenario.

      This class is used to represent the details of an error and specifies the name of the property and the description of each of the errors associated with that property.

      Hide errors attributes Show errors attributes object
      • propertyName string | null

        The name of the property involved in the error.

      • description array[string] | null

        A description of each error associated with the given property.

GET /v1/customers/{customerId}/subscriptions/{subscriptionId}/eligible-transitions
curl \
 --request GET 'https://app-cloudcockpitapi-prod-01.azurewebsites.net/v1/customers/{customerId}/subscriptions/{subscriptionId}/eligible-transitions' \
 --header "X-Tenant: portal.cloudcockpit.com" \
 --header "Authorization: Bearer eyJ0eXAiO..." \
 --header "X-Correlation-Id: string"