Skip to main content

Get All Scores

This endpoint retrieves all score history entries.

info

This operation requires admin or moderation role.

HTTP Request

GET /api/v2/score/

Parameters

NameInTypeRequiredDescription
limitqueryintegerfalseNumber of results to return per page
offsetqueryintegerfalseThe initial index from which to return the results
searchquerystringfalseSearch by username, comment or reputation_context
user_idqueryintegerfalseFilter by user id
reputation_typequeryintegerfalseFilter by reputation type
reputed_at_fromquerystring(datetime)falseFilter results with reputed_at greater than or equal to this datetime
reputed_at_toquerystring(datetime)falseFilter results with reputed_at lower than or equal to this datetime
exclude_manualquerybooleanfalseExclude manual reputation entries
exclude_resetquerybooleanfalseExclude reset reputation entries
orderingquerystringfalseWhich field to use when ordering the results

Search Fields

The search parameter supports:

  • user.username
  • comment
  • reputation_context

Example Request

curl -X GET "/api/v2/score/?search=contest&exclude_reset=true&ordering=-reputed_at" \
-H "Accept: application/json" \
-H "Authorization: Bearer {access_token}"

Responses

StatusMeaningDescription
200OKSuccessful response
401UnauthorizedMissing or invalid access token
403ForbiddenUser does not have moderation permissions

Response Schema

NameTypeDescription
countintegerTotal results count
nextstring(uri) or nullNext page url
previousstring(uri) or nullPrevious page url
resultsarrayList of score entries

Example Response

{
"count": 2,
"next": null,
"previous": null,
"results": [
{
"id": 456,
"user": {
"id": 123,
"username": "mario.rossi",
"real_name": "Mario Rossi",
"avatar": "https://example.com/avatar.jpg",
"reputation": 110
},
"score": 10,
"reputation_type": 10,
"reputation_type_description": "manual",
"comment": "Winner of the APIS contest",
"reputation_context": "contest|first_place|apis",
"created_by": {
"id": 1,
"username": "moderator",
"avatar": "https://example.com/avatar.jpg"
},
"reputed_at": "2026-05-20T10:30:00Z"
},
{
"id": 457,
"user": {
"id": 124,
"username": "anna.bianchi",
"real_name": "Anna Bianchi",
"avatar": "https://example.com/avatar.jpg",
"reputation": 95
},
"score": -5,
"reputation_type": 10,
"reputation_type_description": "manual",
"comment": "Score correction",
"reputation_context": "manual|correction",
"created_by": {
"id": 1,
"username": "moderator",
"avatar": "https://example.com/avatar.jpg"
},
"reputed_at": "2026-05-20T11:15:00Z"
}
]
}