---
title: "Get Dialer Leaderboard"
method: GET
path: "/analytics/dialer/leaderboard"
tags: ["Dialer Analytics"]
---

# Get Dialer Leaderboard

`GET /analytics/dialer/leaderboard`

## Request

- Base URL: `https://be.graph8.com/api/v1`
- URL: `https://be.graph8.com/api/v1/analytics/dialer/leaderboard`
- Auth: HTTP bearer

Org-wide SDR leaderboard ranked by meetings booked.

Accepts either explicit `start_date`/`end_date` or a `period` preset.
If neither is provided, defaults to today.

## Query parameters

- `period` 'today' | 'week' | 'month', nullable: Time period preset (fallback if no dates)
- `start_date` string, nullable: Start date (YYYY-MM-DD)
- `end_date` string, nullable: End date (YYYY-MM-DD)
- `tz` string, nullable: Viewer's IANA timezone (e.g. Asia/Karachi). start_date/end_date and the daily buckets are read as calendar days in it. Omit for UTC days.

## Headers

- `Authorization` string, nullable
- `X-Org-Id` string, nullable

## Response `200`

Successful Response

- DialerAnalyticsResponse: Standard dialer analytics response wrapper.
  - `success` boolean
  - `data` union, required
    - object
    - unknown[]
      - unknown
  - `meta` DialerAnalyticsMeta, required: Metadata for dialer analytics responses.
    - `org_id` string, required
    - `cached` boolean, required
    - `timestamp` string, date-time, required
    - `query_time_ms` number, nullable
    - `degraded` boolean
    - `reason` string, nullable

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/graph8/apis/graph8-developer-api.md) · [All operations](https://skmtc.dev/graph8/apis/graph8-developer-api/llms.txt) · [OpenAPI document](https://skmtc.dev/graph8/apis/graph8-developer-api/revisions/89fc11143b70?raw)