---
title: "Get Org Subscription"
method: GET
path: "/api/billing/org-subscription"
---

# Get Org Subscription

`GET /api/billing/org-subscription`

Fetch the billing subscription for the authenticated user's organization.

This endpoint requires authentication and uses the org_id from the user's session.
Returns subscription data including trial dates, status, plan details, and subscription items.

Args:
    request: FastAPI request object
    user_id: User ID (injected by @require_auth)
    org_id: Organization ID (injected by @require_auth)

Returns:
    Dictionary containing:
        - status: Subscription status (e.g., "trialing", "active", "past_due")
        - trial_starts_at: ISO 8601 timestamp when trial started (if applicable)
        - trial_ends_at: ISO 8601 timestamp when trial ends (if applicable)
        - plan_id: ID of the billing plan
        - plan_name: Name of the billing plan
        - subscription_items: List of subscription item details
        - server_time: Current server time in ISO 8601 format

Raises:
    HTTPException: If org_id is missing or subscription cannot be fetched

## Query parameters

- `user_id` string
- `org_id` string

## Response `200`

Successful Response

- object

## Other responses

- `422` — Validation Error

---

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