---
title: "Billing Trial Status"
method: GET
path: "/api/billing/trial-status"
tags: ["auth", "billing"]
---

# Billing Trial Status

`GET /api/billing/trial-status`

## Request

- Base URL: `https://www.oxfordledge.com` (the document declares no server; this is the origin it was published from)
- URL: `https://www.oxfordledge.com/api/billing/trial-status`
- Auth: none declared

Return feature trial usage from the feature_trials table.

Returns {used, remaining, max} for the given feature.
Unauthenticated users get full trial allowance (encouraging signup).

## Query parameters

- `feature` string

## Response `200`

Successful Response

- BillingActionResponse: Loose response_model for billing routes (Stripe portal, checkout sessions, webhooks). Varies by action.

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/oxfordledge/apis/oxford-ledge-api.md) · [All operations](https://skmtc.dev/oxfordledge/apis/oxford-ledge-api/llms.txt) · [OpenAPI document](https://skmtc.dev/oxfordledge/apis/oxford-ledge-api/revisions/e832a1260f0b?raw)