---
title: "Get Subscription"
method: GET
path: "/api/user/subscription"
tags: ["user"]
---

# Get Subscription

`GET /api/user/subscription`

Get subscription details including Stripe portal URL for management.

Also updates subscription status based on current Stripe entitlements.
This ensures status is refreshed after successful payment.

## Response `200`

Successful Response

- SubscriptionStatusResponse — Subscription status response - unified model for all subscription states. Status can be: - "trialing": User is on trial (has trial_expires, days_remaining) - "active": Active Stripe subscription (has plan, amount, currency, etc.) - "canceled": Had subscription but canceled (has portal_url) - "none": No subscription or trial
  - `status` string, required
  - `trial_expires` integer, nullable
  - `days_remaining` integer, nullable
  - `price_id` string, nullable
  - `plan` string, nullable
  - `amount` integer, nullable
  - `currency` string, nullable
  - `current_period_end` integer, nullable
  - `cancel_at_period_end` boolean, nullable
  - `portal_url` string, nullable
  - `spend` number, nullable
  - `max_budget` number, nullable
  - `budget_reset_at` integer, nullable
  - `total_files_mb` number, nullable
  - `storage_quota_mb` integer, nullable

## Changes

- **2025-11-03** `d6c3e911a263` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/arbicity/apis/arbi/changes/api/user/subscription/get.md)

---

[API](https://skmtc.dev/arbicity/apis/arbi.md) · [All operations](https://skmtc.dev/arbicity/apis/arbi/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/arbicity/arbi/revisions/aa4b06f8dede/schema)