# Members API
> Source: /api-reference/members/overview
> Customer-facing API for member profile, loyalty, and reservations

# Members API

The Members API provides authenticated access to member-specific features.

## Base URL [#base-url]

```
https://api.journey.com/members
```

## Authentication [#authentication]

All endpoints require Clerk JWT authentication:

```http
Authorization: Bearer <CLERK_JWT_TOKEN>
```

## Core Features [#core-features]

<CardGroup cols={2}>
  <Card title="Profile Management" icon="user">
    Member details, preferences, and contacts
  </Card>
  <Card title="Loyalty & Wallet" icon="coins">
    Points, tiers, benefits, and transactions
  </Card>
  <Card title="Property Search" icon="magnifying-glass">
    Discovery, filters, and availability
  </Card>
  <Card title="Reservations" icon="calendar">
    Bookings, history, and management
  </Card>
</CardGroup>

## Response Structure [#response-structure]

```json
{
  "member": {...},
  "profile": {...},
  "wallet": {...},
  "loyalty": {...}
}
```

## Common Patterns [#common-patterns]

### Pagination [#pagination]

```typescript
interface PaginatedRequest {
  limit: number;  // Max items per page
  offset: number; // Skip items
}

interface PaginatedResponse<T> {
  items: T[];
  total: number;
  limit: number;
  offset: number;
}
```

### Error Handling [#error-handling]

```typescript
try {
  const response = await fetch('/members/me');
  if (!response.ok) {
    const error = await response.json();
    console.error('API Error:', error.message);
  }
} catch (err) {
  console.error('Network error:', err);
}
```