# Get top customers by points earned

Retrieves a paginated list of top customers ranked by loyalty points earned. Useful for generating leaderboards, identifying VIP customers, and analyzing customer engagement.

Endpoint: GET /api/external/top-customers

## Header parameters:

  - `X-API-Key` (string, required)
    API key for authentication

## Query parameters:

  - `pageable` (object, required)
    Pagination parameters (page number, size, sort)

## Response 200 fields (application/json):

  - `customerId` (integer)

  - `firstName` (string)

  - `lastName` (string)

  - `pointsEarned` (number)

  - `activitiesCompleted` (integer)


## Response 401 fields