---
title: "Change Plan"
method: POST
path: "/v1/users/me/billing/change-plan"
---

# Change Plan

`POST /v1/users/me/billing/change-plan`

## Request

- Base URL: `https://api.mireye.com`
- URL: `https://api.mireye.com/v1/users/me/billing/change-plan`
- Auth: none declared
- TypeScript: <https://skmtc.dev/mireye/apis/mireye-earth/docs/v1/users/me/billing/change-plan/post.ts> (a function with typed inputs; its response is checked against the schema)

Schedule the requested price for the next renewal; no proration or grant.

## Request body

- CheckoutRequest
  - `coupon_code` string, nullable
  - `plan_id` string, required

## Response `200`

Successful Response

- object

## Other responses

- `422`: Validation Error

## Changes

- **2026-11-11** `8c777dbffa20`: 1 info
  - added the new optional request property `coupon_code`

[Operation history](https://skmtc.dev/mireye/apis/mireye-earth/changes/v1/users/me/billing/change-plan/post.md)

---

[API](https://skmtc.dev/mireye/apis/mireye-earth.md) - [All operations](https://skmtc.dev/mireye/apis/mireye-earth/llms.txt) - [OpenAPI document](https://skmtc.dev/mireye/apis/mireye-earth/revisions/8c777dbffa20?raw)