---
title: "Get dataset leaderboard"
method: GET
path: "/api/datasets/{namespace}/{repo}/leaderboard"
tags: ["datasets"]
---

# Get dataset leaderboard

`GET /api/datasets/{namespace}/{repo}/leaderboard`

Returns the evaluation results ranked by score for a dataset/task

## Path parameters

- `namespace` string, required
- `repo` string, required

## Query parameters

- `task_id` string
- `max_params` string
- `base_model` boolean

## Response `200`

Evaluation results

- object[]
  - `rank` number, required
  - `modelId` string, required
  - `author` union, required
    - object
      - `_id` string, required
      - `avatarUrl` string, required
      - `fullname` string, required
      - `name` string, required
      - `isHf` boolean, required
      - `isHfAdmin` boolean, required
      - `isMod` boolean, required
      - `followerCount` number
      - `type` 'org', required
      - `plan` 'team' | 'enterprise' | 'plus' | 'academia'
      - `isUserFollowing` boolean
    - object
      - `_id` string, required
      - `avatarUrl` string, required
      - `fullname` string, required
      - `name` string, required
      - `isHf` boolean, required
      - `isHfAdmin` boolean, required
      - `isMod` boolean, required
      - `followerCount` number
      - `type` 'user', required
      - `isPro` boolean, required
      - `isUserFollowing` boolean
      - `primaryOrg` object
        - `avatarUrl` string, required
        - `fullname` string, required
        - `name` string, required
        - `type` 'org', required
        - `isHf` boolean, required
        - `isFollowing` boolean
        - `plan` 'team' | 'enterprise' | 'plus' | 'academia'
        - `details` string
        - `hasPrivateMembersList` boolean
        - `userRole` union
          - 'admin' | 'write' | 'contributor' | 'read' | 'no_access'
          - string — Custom role name
        - `numUsers` number
  - `value` number, required
  - `verified` boolean
  - `source` object
    - `url` string, required
    - `name` string
    - `isExternal` boolean, required
    - `author` union
      - object
        - `_id` string, required
        - `avatarUrl` string, required
        - `fullname` string, required
        - `name` string, required
        - `isHf` boolean, required
        - `isHfAdmin` boolean, required
        - `isMod` boolean, required
        - `followerCount` number
        - `type` 'org', required
        - `plan` 'team' | 'enterprise' | 'plus' | 'academia'
        - `isUserFollowing` boolean
      - object
        - `_id` string, required
        - `avatarUrl` string, required
        - `fullname` string, required
        - `name` string, required
        - `isHf` boolean, required
        - `isHfAdmin` boolean, required
        - `isMod` boolean, required
        - `followerCount` number
        - `type` 'user', required
        - `isPro` boolean, required
        - `isUserFollowing` boolean
        - `primaryOrg` object
          - `avatarUrl` string, required
          - `fullname` string, required
          - `name` string, required
          - `type` 'org', required
          - `isHf` boolean, required
          - `isFollowing` boolean
          - `plan` 'team' | 'enterprise' | 'plus' | 'academia'
          - `details` string
          - `hasPrivateMembersList` boolean
          - `userRole` union
            - 'admin' | 'write' | 'contributor' | 'read' | 'no_access'
            - string — Custom role name
          - `numUsers` number
  - `pullRequest` number
  - `filename` string, required
  - `notes` string
  - `lower_is_better` boolean
  - `num_parameters` number

---

[API](https://skmtc.net/huggingface/apis/hub-api-endpoints.md) · [All operations](https://skmtc.net/huggingface/apis/hub-api-endpoints/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/huggingface/hub-api-endpoints/versions/6ab9f7d9cfb5/schema)