---
title: "Read monthly plan and Enterprise trial status"
method: GET
path: "/credits/plans"
tags: ["Tenant"]
---

# Read monthly plan and Enterprise trial status

`GET /credits/plans`

## Request

- Base URL: `https://api.paywithlocus.com/api`
- URL: `https://api.paywithlocus.com/api/credits/plans`
- Auth: HTTP bearer

Requires a human workspace session with tenant:read. Trial expiry pauses Enterprise features without erasing prepaid balances or changing the assigned usage rate. Complete paid Enterprise checkout to restore those features; a top-up does not extend the trial.

## Query parameters

- `refresh` boolean

## Response `200`

Current subscription, trial deadline and checkout availability

- object
  - `success` unknown
  - `enterpriseTrial` object, nullable: A stored Enterprise trial: 7 days for an invited workspace, 14 for an operator upgrade. Paid conversion clears the visible trial, preserves its audit dates and keeps the assigned usage-pricing profile.
    - `status` 'active' | 'expired', required
    - `startedAt` string, date-time, required
    - `endsAt` string, date-time, required
  - `enabled` boolean
  - `currentPlan` 'free' | 'plus' | 'enterprise' | 'enterprise_plus'
  - `legacy` boolean
  - `checkoutConfigured` boolean
  - `includedBalanceUsd` string
  - `includedExpiresAt` string, date-time, nullable

## Other responses

- `403`: Human workspace membership is required

---

[API](https://skmtc.dev/paywithlocus/apis/locus-pro-api.md) - [All operations](https://skmtc.dev/paywithlocus/apis/locus-pro-api/llms.txt) - [OpenAPI document](https://skmtc.dev/paywithlocus/apis/locus-pro-api/revisions/aab8fa5d6cef?raw)