---
title: "Get top customers by points earned"
method: GET
path: "/api/external/top-customers"
tags: ["Points & Earn Rules"]
---

# Get top customers by points earned

`GET /api/external/top-customers`

## Query parameters

- `pageable` Pageable, required
  - `page` integer
  - `size` integer
  - `sort` string[]

## Headers

- `X-API-Key` string, required

## Response `200`

Successfully retrieved top customers with pagination headers

- TopCustomerVM
  - `activitiesCompleted` integer
  - `customerId` integer
  - `firstName` string
  - `lastName` string
  - `pointsEarned` number, double

## Other responses

- `401` — Unauthorized - Invalid or missing X-API-Key

---

[API](https://skmtc.net/appstle/apis/admin-apis.md) · [All operations](https://skmtc.net/appstle/apis/admin-apis/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/appstle/admin-apis/versions/fd4af3eaa936/schema)