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

# Get Plan Details

> Returns the full details for a specific plan (tariff).

# Get Plan Details

Returns the full configuration and pricing details for a specific plan. Used on the plan detail page to show features, pricing tiers, and included benefits.

## Authentication

No authentication required for public plan details.

## Path Parameters

<ParamField path="planId" type="number" required>
  Numeric identifier of the plan. Returned as `Id` from the published plans endpoint.
</ParamField>

## Query Parameters

<ParamField query="_shape" type="string">
  Comma-separated list of field paths to include in the response. When provided, only the
  specified fields are returned — useful for reducing payload size. Supports nested paths
  using dot notation. Example: `_shape=Name,Price,Description,InvoiceEvery,TimePasses,ExtraServices`.
</ParamField>

## Response

Returns a `Tariff` object with full plan configuration.

<ResponseField name="Id" type="number" required>
  Unique identifier for the plan.
</ResponseField>

<ResponseField name="Name" type="string" required>
  Display name of the plan.
</ResponseField>

<ResponseField name="Description" type="string">
  Full plan description. May contain HTML.
</ResponseField>

<ResponseField name="Price" type="number">
  Base recurring price.
</ResponseField>

<ResponseField name="PriceCurrencyCode" type="string">
  ISO 4217 currency code.
</ResponseField>

## Examples

### Fetch plan details

```http theme={null}
GET /api/public/plans/12
```

## TypeScript Integration

```typescript theme={null}
import endpoints from '@/api/endpoints'

const { resource: plan } = useTypedData(httpClient, endpoints.plans.one(12))
```
