> ## Documentation Index
> Fetch the complete documentation index at: https://docs.memorylake.ai/llms.txt
> Use this file to discover all available pages before exploring further.
# Preview Plan Change
> Prices switching the subscription to plan_id without changing anything: the prorated amount charged now, its line items, when the change takes effect and the next full invoice
```
GET /openapi/memorylake/admin/v1/billing/subscription/plan-change-preview
```
Prices switching the subscription to plan\_id without changing anything: the prorated amount charged now, its line items, when the change takes effect and the next full invoice. proration\_date echoes the instant the proration was computed for. Switches that cost nothing come back with applicable false and a reason. Changing the plan itself is done in the console.
**Permission required:** `subscription:manage`
### Query Parameters
The plan to price a switch to
```bash cURL theme={null}
curl -X GET 'https://app.memorylake.ai/openapi/memorylake/admin/v1/billing/subscription/plan-change-preview?plan_id=9e50b1aed525a8280e28b9662b6a7ba0' \
-H 'Authorization: Bearer sk_xxxxxx'
```
### Response
false = nothing to price: see reason. The change itself may still be valid.
Line items behind amount\_due; empty when not applicable
Line amount; negative for credit for unused time
Amount in the currency's smallest unit (cents for usd)
Lowercase ISO 4217 currency code
Line description
true for a prorated line
Service period end, Unix seconds
Service period start, Unix seconds
The target plan, as requested
Charged immediately if the change were made now (prorated); negative = credit to the balance. Present when applicable.
Amount in the currency's smallest unit (cents for usd)
Lowercase ISO 4217 currency code
When the change would take effect, Unix seconds: now for an upgrade, the period end for a downgrade to free
The current plan
Plan id
Plan name
The first full-cycle invoice on the new plan. Present when applicable.
Full price of the new plan for one cycle
Amount in the currency's smallest unit (cents for usd)
Lowercase ISO 4217 currency code
When it is issued, Unix seconds
The instant the proration was computed for, Unix seconds. Present when applicable.
Why there is nothing to price: no\_paid\_subscription (the current subscription is not paid through the payment provider), downgrade\_to\_free (moving to the free plan takes effect at period end, no charge), resume\_only (target is the current plan of a subscription set to cancel: switching back only resumes it)
The target plan
Plan id
Plan name
```json Success (200) theme={null}
{
"success": true,
"message": "Operation completed successfully",
"data": {
"applicable": false,
"lines": [
{
"amount": {
"amount": 1999,
"currency": "usd"
},
"description": "Example description",
"proration": false,
"period_end": 1760000000,
"period_start": 1760000000
}
],
"plan_id": 1,
"amount_due": {
"amount": 1999,
"currency": "usd"
},
"effective_at": 1760000000,
"from_plan": {
"id": 1,
"name": "Example name"
},
"next_invoice": {
"amount": {
"amount": 1999,
"currency": "usd"
},
"date": 1
},
"proration_date": 1,
"reason": "no_paid_subscription",
"to_plan": {
"id": 1,
"name": "Example name"
}
}
}
```
### Errors
Errors answer with `success: false`, a `message` and an `error_code`. See [Error Codes](/features/memorylake/api-reference/errors) for every code.
| Status | Meaning |
| - | - |
| `400` | A parameter or the body is invalid |
| `401` | The API key is missing, invalid, disabled or expired |
| `403` | The key is not allowed to do this |
| `409` | The request conflicts with the current state, e.g. a duplicate or a limit reached |
| `422` | The body or a parameter failed validation |
| `429` | Too many requests. Wait for the time in `Retry-After` |
| `500` | Server-side error |
| `503` | Temporarily unavailable. Retry later |
This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.