# Get Perks for Group
> Source: /api-reference/members/loyalty/get-perks-for-group
> Get all perks belonging to a perk group
> Endpoint: GET /members/me/loyalty/perk-groups/{id}/perks

## Overview [#overview]

Returns all individual perks that belong to a specific perk group. This shows the detailed benefits available within that group.

## 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 to get perks for
</ParamField>

<RequestExample>

```bash cURL
curl -X GET "http://localhost:3000/v1/members/me/loyalty/perk-groups/1/perks" \
  -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}/perks`, {
  method: 'GET',
  headers: {
    'Authorization': 'Bearer YOUR_CLERK_JWT'
  }
});

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

</RequestExample>

## Response [#response]

<ResponseField name="items" type="array" required>
  List of perks in this group
  
  <Expandable title="array items">
    <ResponseField name="id" type="number" required>
      Unique perk ID
    </ResponseField>
    
    <ResponseField name="documentId" type="string">
      Document identifier for the perk
    </ResponseField>
    
    <ResponseField name="name" type="string" required>
      Display name of the perk
    </ResponseField>
    
    <ResponseField name="description" type="string">
      Description of what this perk provides
    </ResponseField>
    
    <ResponseField name="headline" type="string">
      Short marketing headline for the perk
    </ResponseField>
  </Expandable>
</ResponseField>

<ResponseField name="total" type="number" required>
  Total number of perks in this group
</ResponseField>

<ResponseExample>

```json 200 Response
{
  "items": [
    {
      "id": 15,
      "documentId": "perk_suite_upgrade",
      "name": "Complimentary Suite Upgrade",
      "description": "Upgrade to the next available suite category at no additional charge",
      "headline": "Elevate Your Stay"
    },
    {
      "id": 16,
      "documentId": "perk_late_checkout", 
      "name": "Late Checkout",
      "description": "Extended checkout time until 4:00 PM subject to availability",
      "headline": "Extra Time to Unwind"
    },
    {
      "id": 17,
      "documentId": "perk_vip_amenities",
      "name": "VIP Welcome Amenities",
      "description": "Luxury welcome amenities delivered to your suite upon arrival",
      "headline": "Premium Welcome Experience"
    }
  ],
  "total": 3
}
```

</ResponseExample>

## Related Endpoints [#related-endpoints]

- [Get Perk Group](/api-reference/members/loyalty/get-perk-group) - Get details of this perk group
- [Get Available Perks](/api-reference/members/loyalty/get-available-perks) - Get all perks available to member