---
title: "Get Modality Rankings"
method: GET
path: "/app/rankings/{modality}"
tags: ["Rankings"]
---

# Get Modality Rankings

`GET /app/rankings/{modality}`

## Request

- Base URL: `https://api.muapi.ai`
- URL: `https://api.muapi.ai/app/rankings/{modality}`
- Auth: one of:
  - API key in header `x-api-key`
  - OAuth 2 (client credentials, token URL `https://api.muapi.ai/oauth/token`)

Public leaderboard endpoint scoped to a specific modality ('image', 'video', 'audio', 'all').

## Path parameters

- `modality` string, required

## Query parameters

- `window` string: Time window: 'week' (7 days) or 'month' (30 days)
- `metric` string: Metric to rank by: 'requests' or 'cost'

## Response `200`

Successful Response

- object

## Other responses

- `422`: Validation Error

---

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