> For the complete documentation index, see [llms.txt](https://exiles-interactive.gitbook.io/centarius-api-documentation/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://exiles-interactive.gitbook.io/centarius-api-documentation/users-and-leaderboards/leaderboards-retrieval.md).

# Leaderboards - Retrieval

You might need to retrieve saved leaderboards of your game from Centarius for display in your game to your players. Use this call to get a `JSON` of all your saved leaderboard entries.

#### Request URL

```http
POST https://www.centarius.app/get-leaderboard/
```

#### Request Body

<table><thead><tr><th width="150">Name</th><th width="114">Required</th><th width="126">Type</th><th>Description</th></tr></thead><tbody><tr><td><code>game_id</code></td><td><code>True</code></td><td><code>string</code></td><td>Your game's Centarius game ID. </td></tr></tbody></table>

#### Response&#x20;

<table><thead><tr><th width="166">Code</th><th width="176">Type</th><th>Response</th></tr></thead><tbody><tr><td><code>200</code></td><td><code>JsonResponse</code></td><td><code>[...{"game_id": your_id, "userID": a_user_id, "score": saved_score}...]</code></td></tr><tr><td><code>500</code></td><td><code>JsonResponse</code></td><td><code>{'error': Exception as str}</code></td></tr></tbody></table>