# Get Perk Group
> Source: /api-reference/members/loyalty/get-perk-group
> Get details of a specific perk group
> Endpoint: GET /members/me/loyalty/perk-groups/{id}

## Overview [#overview]

Returns detailed information about a specific perk group including its configuration and status.

## Authentication [#authentication]

Requires a valid Clerk JWT token in the Authorization header.

## Path Parameters [#path-parameters]

<ParamField path="id" type="number" required>
  Perk group ID
</ParamField>

<RequestExample>

```bash cURL
curl -X GET "http://localhost:3000/v1/members/me/loyalty/perk-groups/1" \
  -H "Authorization: Bearer YOUR_CLERK_JWT"
```

```typescript TypeScript
const perkGroupId = 1;
const response = await fetch(`http://localhost:3000/v1/members/me/loyalty/perk-groups/${perkGroupId}`, {
  method: 'GET',
  headers: {
    'Authorization': 'Bearer YOUR_CLERK_JWT'
  }
});

const perkGroup = await response.json();
```

</RequestExample>

## Response [#response]

<ResponseField name="id" type="number" required>
  Unique perk group ID
</ResponseField>

<ResponseField name="documentId" type="string" required>
  Document identifier for the perk group
</ResponseField>

<ResponseField name="name" type="string" required>
  Display name of the perk group
</ResponseField>

<ResponseField name="description" type="string">
  Description of the perk group and its benefits
</ResponseField>

<ResponseField name="enabled" type="boolean" required>
  Whether this perk group is currently active
</ResponseField>

<ResponseField name="stayRequired" type="boolean" required>
  Whether perks in this group require an active reservation
</ResponseField>

<ResponseField name="createdAt" type="string" required>
  ISO 8601 timestamp when perk group was created
</ResponseField>

<ResponseField name="updatedAt" type="string" required>
  ISO 8601 timestamp when perk group was last updated
</ResponseField>

<ResponseExample>

```json 200 Response
{
  "id": 1,
  "documentId": "pg_suite_benefits",
  "name": "Suite Benefits",
  "description": "Exclusive perks and upgrades for suite accommodations",
  "enabled": true,
  "stayRequired": true,
  "createdAt": "2024-01-15T10:00:00Z",
  "updatedAt": "2024-03-20T14:30:00Z"
}
```

```json 404 Response - Not Found
{
  "statusCode": 404,
  "message": "Perk group not found"
}
```

</ResponseExample>

## Related Endpoints [#related-endpoints]

- [Get Perk Groups](/api-reference/members/loyalty/get-perk-groups) - List all available perk groups
- [Get Perks for Group](/api-reference/members/loyalty/get-perks-for-group) - Get all perks within this group