> 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-saving-scores.md).

# Leaderboards - Saving Scores

With contests being a defining feature of the Centarius platform, it is paramount to save your players' game scores using the API. Use this call whenever a unique player obtains a new score to be uploaded to the leaderboards on Centarius. 

#### Request URL

```http
POST https://www.centarius.app/enter-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><tr><td><code>userID</code></td><td><code>True</code></td><td><code>string</code></td><td>The unique identifier for the user that your game uses. </td></tr><tr><td><code>score</code></td><td><code>True</code></td><td><code>integer</code></td><td>The player's new score.</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>HttpResponse</code></td><td>Leaderboard entry saved successfully.</td></tr><tr><td><code>500</code></td><td><code>JsonResponse</code></td><td><code>{'error': Exception as str}</code></td></tr></tbody></table>