---
title: "Get rank range of the list"
method: GET
path: "/lists/{list_id}/range"
tags: ["lists"]
---

# Get rank range of the list

`GET /lists/{list_id}/range`

Get rank range of the list.
Either `from_top` or `from_bottom` must be supplied

Required security scopes:
  * `api:read`

## Path parameters

- `list_id` string, required

## Query parameters

- `from_bottom` integer
- `from_top` integer
- `limit` integer

## Response `200`

OK

## Other responses

- `400` — Bad Request
- `401` — Unauthorized
- `404` — Not Found

---

[API](https://skmtc.net/vivino/apis/the-rankdb-api.md) · [All operations](https://skmtc.net/vivino/apis/the-rankdb-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/vivino/the-rankdb-api/revisions/7a45b5309a11/schema)