# Speaker Balance Score

### Endpoint

```
GET /single-feature-api/meeting/balance-score
```

### Parameters

| Name          | Type   | Description                         |
| ------------- | ------ | ----------------------------------- |
| Authorization | Header | Bearer token for authentication.    |
| file-hash     | Query  | Hash of the meeting recording file. |

### Request Headers

The request should include the following header:

```
Authorization: Bearer <token>
```

### Request Query Parameters

The request should include the following query parameter:

| Name      | Type   | Required | Description                         |
| --------- | ------ | -------- | ----------------------------------- |
| file-hash | string | true     | Hash of the meeting recording file. |

### Responses

| HTTP Code | Description                                                    |
| --------- | -------------------------------------------------------------- |
| 200       | Success. Returns the meeting balance score as a JSON response. |
| 400       | Bad request. Invalid or missing parameters.                    |
| 401       | Unauthorized. Invalid or expired token.                        |
| 404       | Meeting not found.                                             |

#### Success Response

**HTTP Code:** 200

**Response Body:**

```json
{
  "balance_score": 100
}
```

#### Error Responses

**HTTP Code:** 400

**Response Body:**

```json
{
  "message": "Bad request"
}
```

**HTTP Code:** 401

**Response Body:**

```json
{
  "message": "Unauthorized"
}
```

**HTTP Code:** 404

**Response Body:**

```json
{
  "message": "Meeting not found"
}
```

### Example

#### Request

```
GET /single-feature-api/meeting/balance-score?file-hash=7faa938dfb14e7ca8129a40a7e47bb02
Authorization: Bearer <token>
```

#### Response

```
HTTP/1.1 200 OK
Content-Type: application/json

{
  "balance_score": 100
}
```

### Error Codes

| HTTP Code | Description                                 |
| --------- | ------------------------------------------- |
| 400       | Bad request. Invalid or missing parameters. |
| 401       | Unauthorized. Invalid or expired token.     |
| 404       | Meeting not found.                          |