> For the complete documentation index, see [llms.txt](https://id-docs.fsl.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://id-docs.fsl.com/developers/reputation-score/upload-reputation-score.md).

# Upload Reputation Score

Create your customized reputation score first before uploading the data.

The minimum granularity of reputation score data is day-level. You may upload at daily basis.

## Pre-requisite

Make sure the `ReputationScore` [Grant Scope](/developers/grant-scope.md) is included when requesting authorization. You cannot share or retrieve reputation scores without approval from the user.

## API

<mark style="color:green;">`Post`</mark> `/api/account/party/dataReport`

**Header**

| Name          | Value                   |
| ------------- | ----------------------- |
| Content-Type  | `application/json`      |
| Authorization | `Bearer <access token>` |

**Parameters**

Compose all parameters below as a JSON. Check the request example for details.

<table><thead><tr><th width="157">Name</th><th width="113">Mandatory?</th><th>Description</th></tr></thead><tbody><tr><td><code>time</code></td><td>Y</td><td>The timestamp of the UTC day that indicates the data belongs to. The timestamp should be in seconds.<br>The data that happened within <mark style="color:blue;">7</mark> days will be accepted, otherwise rejected.</td></tr><tr><td><code>network</code></td><td>Y</td><td>Network ID, AKA blockchain ID.<br><code>Ethereum: 1</code><br><code>BSC: 56</code><br><code>Polygon: 137</code><br><code>Solana: -1</code></td></tr><tr><td><code>data</code></td><td>Y</td><td>All reputation scores</td></tr></tbody></table>

**Request Example**

```sh
curl --location 'https://$API_BASE_URL/api/account/party/dataReport' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer access_token'
--data '{
    "time": 1722355400,
    "network": 1,
    "data": {
        "Trade Volume": 1000000,
        "Active": 1,
        "Your Defined Score": 100,
        "note": "Your comment"
    }
}'
```

**Response**

{% tabs %}
{% tab title="Error Code" %}

```json
{
    "code": 10001,
    "message": "Incorrect timestamp"
}
/*
10001: Incorrect timestamp
203000: Incorrect parameters 
208004: Invalid access token
301002: User doesn't exist
208403: No user grant or revoked
*/
```

{% endtab %}

{% tab title="200" %}

```json
{
    "code": 0
}
```

{% endtab %}
{% endtabs %}
