---
title: "Get Subscription Status"
method: GET
path: "/payments/subscription-status/{subscription_id}"
tags: ["payments"]
---

# Get Subscription Status

`GET /payments/subscription-status/{subscription_id}`

## Request

- Base URL: `https://api.oxlo.ai` (the document declares no server; this is the origin it was published from)
- URL: `https://api.oxlo.ai/payments/subscription-status/{subscription_id}`
- Auth: HTTP bearer

Poll subscription status for processing payment reconciliation.

Called by frontend when PaymentIntent is in 'processing' state.
Checks Stripe in real-time and returns current status.

Returns:
    status: 'active' | 'processing' | 'failed' | 'requires_action'
    plan: the plan associated with the subscription

## Path parameters

- `subscription_id` string, required

## Response `200`

Successful Response

- unknown

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/oxlo/apis/oxlo-backend.md) - [All operations](https://skmtc.dev/oxlo/apis/oxlo-backend/llms.txt) - [OpenAPI document](https://skmtc.dev/oxlo/apis/oxlo-backend/revisions/bc2ecdc94f31?raw)