---
title: "Sender leaderboard"
method: GET
path: "/sequences/analytics/leaderboard/"
tags: ["sequences"]
---

# Sender leaderboard

`GET /sequences/analytics/leaderboard/`

## Request

- Base URL: `https://api.getoneprofile.ai` (the document declares no server; this is the origin it was published from)
- URL: `https://api.getoneprofile.ai/sequences/analytics/leaderboard/`
- Auth: one of:
  - API key in header `X-API-Key`
  - HTTP bearer

Every mailbox's sent, reply and bounce numbers under its sender, worst performer first, so the one broken mailbox stands out. Served at once from the cached rollup, whatever its age; refreshed_at says how old. When it is more than five minutes old a refresh runs in the background and refreshing is true: read it again a few seconds later for the newer board.

## Response `200`

Successful Response

- SenderLeaderboardReadSchema
  - `linkedin_rows` LinkedInSenderLeaderboardRowReadSchema[]
    - `connections_accepted` integer, required
    - `connections_sent` integer, required
    - `messages_sent` integer, required
    - `replies` integer, nullable, required
    - `sender_profile_id` string, uuid, required
    - `sender_profile_name` string, required
  - `refreshed_at` string, date-time, nullable, required
  - `refreshing` boolean: True when the board was more than five minutes old and a refresh is running in the background. Read it again a few seconds later for newer numbers and a newer refreshed_at.
  - `rows` SenderLeaderboardRowReadSchema[], required
    - `bounce_rate` number, required
    - `bounces` integer, required
    - `contacted` integer
    - `mailbox_email` string, required
    - `mailbox_id` string, uuid, nullable, required
    - `opt_outs` integer, nullable
    - `positive` integer
    - `replies` integer, required
    - `reply_rate` number, required
    - `sender_profile_id` string, uuid, nullable, required
    - `sender_profile_name` string, required
    - `sent` integer, required

## Other responses

- `401`: Unauthorized
- `403`: Forbidden
- `422`: Invalid request made to the API.
- `500`: Internal server error.
- `502`: Bad gateway error.
- `503`: Service unavailable.

---

[API](https://skmtc.dev/getoneprofile/apis/api-reference-oneprofile.md) · [All operations](https://skmtc.dev/getoneprofile/apis/api-reference-oneprofile/llms.txt) · [OpenAPI document](https://skmtc.dev/getoneprofile/apis/api-reference-oneprofile/revisions/dc5ac3c84444?raw)