---
title: "Fetch available switches"
method: GET
path: "/subscription_switches/availability"
---

# Fetch available switches

`GET /subscription_switches/availability`

This endpoint returns all available offers to which a customer can switch from the current subscription in `available` array. Offers to which customer can't switch are returned in `unavailable` array with the reason why the switch is not possible.

## Query parameters

- `customerId` integer, required
- `offerId` string, required

## Headers

- `X-Publisher-Token` string, required

## Response `200`

200

- union
  - object
    - `success` boolean
    - `data` object
      - `available` object[]
        - `algorithm` string
        - `toOfferId` string
        - `switchDirection` string
        - `title` string
        - `price` integer
        - `currency` string
        - `currencySymbol` string
        - `period` string
        - `nextPaymentPrice` number
        - `nextPaymentPriceCurrency` string
        - `nextPaymentPriceCurrencySymbol` string
      - `unavailable` object[]
        - `algorithm` string
        - `toOfferId` string
        - `switchDirection` string
        - `title` string
        - `price` integer
        - `currency` string
        - `currencySymbol` string
        - `period` string
        - `nextPaymentPrice` integer
        - `nextPaymentPriceCurrency` string
        - `nextPaymentPriceCurrencySymbol` string
        - `reason` object
          - `code` string
          - `message` string
    - `message` string
  - object
    - `success` boolean
    - `data` object
      - `available` unknown[]
        - unknown
      - `unavailable` object[]
        - `toOfferId` string
        - `switchDirection` string
        - `title` string
        - `price` integer
        - `currency` string
        - `currencySymbol` string
        - `period` string
        - `nextPaymentPrice` integer
        - `nextPaymentPriceCurrency` string
        - `nextPaymentPriceCurrencySymbol` string
        - `reason` object
          - `code` string
          - `message` string
      - `unavailableReason` object
        - `code` string
        - `message` string
    - `message` string

## Other responses

- `400` — 400
- `404` — 404

---

[API](https://skmtc.net/cleeng/apis/mediastore-api.md) · [All operations](https://skmtc.net/cleeng/apis/mediastore-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/cleeng/mediastore-api/versions/00cbfe7998a4/schema)