> ## Documentation Index
> Fetch the complete documentation index at: https://docs.entityml.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Get Subscription Status

> Return subscription state for a user.

## Request

<ParamField query="user_id" type="string" required>
  User ID to inspect.
</ParamField>

## Response

The response is the stored subscription status for the user. Fields can include `has_subscription`, `subscription_id`, `status`, `tier`, `current_period_start`, and `current_period_end`.

## Example

<CodeGroup>
  ```python Python SDK theme={null}
  from entityml import EntityMLClient

  client = EntityMLClient()
  status = client.billing.get_subscription_status(user_id="YOUR_USER_ID")
  print(status)
  ```

  ```bash CLI theme={null}
  entityml billing subscription-status --user-id YOUR_USER_ID
  ```

  ```bash Raw HTTP (cURL) theme={null}
  curl "https://api.entityml.com/api/v1/subscriptions/status?user_id=YOUR_USER_ID"
  ```
</CodeGroup>

### Example response

```json theme={null}
{
  "has_subscription": true,
  "subscription_id": "sub_...",
  "status": "active",
  "tier": "pro",
  "current_period_start": "2026-05-01T00:00:00+00:00",
  "current_period_end": "2026-06-01T00:00:00+00:00"
}
```