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

# Billing Status

Get the current billing status for a customer, including their active subscription and plan details. This is the primary endpoint for checking what plan a customer is on.

**Auth:** secret key only. Publishable keys are always rejected.

<ParamField query="customer_id" type="string" required>
  External customer ID derived by the trusted merchant backend.
</ParamField>

### Response

Returns the customer's current billing state including subscription and plan information.

<Note>
  Also available as `GET /subscriptions/current` (alias).
</Note>