---
url: https://docs.dataflair.ai/dataflair/toplist-api/playground.md
description: >-
  Send a real request to your own tenant from the browser, or copy the same
  request as curl, PHP, Node or Python.
---

# Toplist API playground

Build a request for [`GET /api/v1/toplists`](/dataflair/toplist-api/toplists-endpoint). Copy it in your language, or send it from this page.

## How the playground works

* The request goes from your browser straight to your tenant. It does not pass through docs.dataflair.ai.
* The tenant must end in `.dataflair.ai`. Any other host is rejected before a request is built.
* Your token stays in memory in this page. It is not stored. It is not put in the address of this page, and it is not put in the code samples.
* The playground only reads. `GET /api/v1/toplists` changes nothing on your tenant.
* A failed request shows its status, its time and the body. It links to the matching row in the [error table](/guide/error-handling).
* If your browser cannot reach your tenant, use the `curl` sample.
* The playground does not follow redirects, so your token is not sent to any host but the one you typed.

## Test this

This page is the test. The same request in `curl`:

```bash
curl "https://{tenant}/api/v1/toplists?page=1" \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -H "Accept: application/json"
```