# User Reports

## Insert user results

<mark style="color:green;">`POST`</mark> `https://api-v2.acrcloud.com/api/bm-bd-projects/:pid/channels/:channel_id/user-reports`

This endpoint allows you to insert the results just like in Timemap or UCF

#### Path Parameters

| Name        | Type   | Description    |
| ----------- | ------ | -------------- |
| pid         | string | The project id |
| channel\_id | string | The channel id |

#### Headers

| Name          | Type   | Description      |
| ------------- | ------ | ---------------- |
| Accept        | string | application/json |
| Authorization | string | Bearer token     |
| Content-Type  | string | application/json |

#### Request Body

| Name                    | Type   | Description                                                                                                                        |
| ----------------------- | ------ | ---------------------------------------------------------------------------------------------------------------------------------- |
| data                    | array  | Result list (\[result1, result2, result3...])                                                                                      |
| result.from             | string | api                                                                                                                                |
| result.title            | string | The title of the result                                                                                                            |
| result.timeoffset       | number | UTC time offsets (For example, UK time is UTC + 00:00, the timeoffset is 0; Hong Kong time is UTC + 08:00, the timeoffset is -480) |
| result.start\_timestamp | string | YYYY-mm-dd HH:MM:SS (For example, 2021-02-01 12:13:14), it is your Local Time.                                                     |
| result.end\_timestamp   | string | YYYY-mm-dd HH:MM:SS (For example, 2021-02-01 12:15:26), it is your Local Time.                                                     |
| result.user\_defined    | object | Other fields of the result (For example, {"artists": "xxx", "album": "xxx", "isrc": "xxx"})                                        |

{% tabs %}
{% tab title="200 " %}

```
{
  "data": {
    "id": 984587,
    "result": {
      "start_timestamp_utc": "2021-05-25 02:35:42",
      "end_timestamp_utc": "2021-05-25 02:36:25",
      "title": "xxx",
      "artist": "",
      "album": "",
      "acrid": "null",
      "duration": 43,
      "played_duration": 43,
      "monitor_type": "",
      "result_type": "custom",
      "from": "api-report",
      "raw_metadata": {
        "title": "xxx",
        "artists": "xxx",
        "album": "xxx"
      },
      "start_timestamp_local": "2021-05-25 10:35:42",
      "end_timestamp_local": "2021-05-25 10:36:25"
    }
  }
}
```

{% endtab %}
{% endtabs %}

{% tabs %}
{% tab title="CURL" %}

```bash
curl --location --request POST 'https://api-v2.acrcloud.com/api/bm-bd-projects/179/channels/100251/user-reports' \
--header 'Accept: application/json' \
--header 'Authorization: Bearer {your token}'
--header 'Content-Type: application/json' \
--data-raw '{"data":[{"from": "api", "title": "xxxx", "timeoffset": 0, "start_timestamp": "2021-02-01 12:13:14", "end_timestamp": "2021-02-01 12:15:26", "user_defined": {"artists": "xxx", "album": "xxx"}}]}'
```

{% endtab %}
{% endtabs %}