---
title: "List Users Scores"
method: GET
path: "/users/scores"
tags: ["Users / Entity"]
---

# List Users Scores

`GET /users/scores`

## Request

- Base URL: `https://api.forcemanager.com/api/v4`
- URL: `https://api.forcemanager.com/api/v4/users/scores`
- Auth: API key in header `X-Session-Key`

This endpoint retrieves the activity and sales Scores of the Users - which measured via the ForceActivity algorithm - based on JSON input. Specifically, an array of JSON data is returned.

You will only receive the Users Scores after first providing the Session Key. To know how you can obtain the Session Key, [go to Authentication](#tag/authentication/POST/login).

**HEADERS**

| **Parameter** | **Value** | **Description** |
| --- | --- | --- |
| Content-Type | application/json | Language in which all request and response bodies are encoded |
| Accept | \*/\* | Any data of whatever mime type is accepted |
| X-Session-Key | AUTH_TOKEN | This field must be completed with the token obtained at the authentication |

**REQUEST**

You can apply filters. The order of the parameters does not matter.

|**Parameter**|**Type**|**Description**|
|---|---|---|
| offset | Integer | Define position from which the records must be returned |
| count | Integer | Define the number of results to return |

e.g.
<pre>https://api.forcemanager.com/api/v4/users/scores?offset=VALUE&count=VALUE</pre>

**RESPONSE**

| **Attribute** | **Type** | **Description** |
| --- | --- | --- |
| id | Object, Null | Unique identifier of the User (see [Users](#) resource) |
| points | Number | User ForceActivity Activities score |
| sales | Number | User ForceActivity Sales score |
| lastUpdate | String | Date in which the score had been updated |

**RESPONSE CODES**

| **Status** | **Description** |
| --- | --- |
| 200 OK | Shows if operation succeeded |
| 400 Bad Request | Shows when an invalid request or the requested service is not available |

## Headers

- `Accept` string

## Response `200`

List Users Scores

---

[API](https://skmtc.dev/forcemanager/apis/sage-sales-management-public-api-documentation-for-developer.md) · [All operations](https://skmtc.dev/forcemanager/apis/sage-sales-management-public-api-documentation-for-developer/llms.txt) · [OpenAPI document](https://skmtc.dev/forcemanager/apis/sage-sales-management-public-api-documentation-for-developer/revisions/87db17204e2f?raw)