# Conversation Emotions

The Meetra AI API provides endpoints for analyzing and extracting emotions from processed meeting recordings. This documentation specifically covers the endpoints related to meeting emotions.

**Endpoint:** `/single-feature-api/meeting/meeting-emotions`

**HTTP Method:** GET

#### Parameters

* `Authorization` (header): Bearer token required for authentication.
* `file-hash` (query): Hash of the meeting recording file.

#### Responses

| HTTP Status Code | Description                                    | Schema                  |
| ---------------- | ---------------------------------------------- | ----------------------- |
| 200              | Meeting emotions score successfully retrieved. | MeetingEmotionsResponse |
| 400              | Bad request.                                   | UploadError400          |
| 401              | Unauthorized.                                  | UploadError401          |
| 404              | Meeting not found.                             | -                       |

**MeetingEmotionsResponse (schema)**

| Property           | Type   | Description             |
| ------------------ | ------ | ----------------------- |
| `meeting_emotions` | object | Meeting emotions score. |

**MeetingEmotions (schema)**

| Property    | Type   | Description      |
| ----------- | ------ | ---------------- |
| `anger`     | number | Anger score.     |
| `disgust`   | number | Disgust score.   |
| `fear`      | number | Fear score.      |
| `happiness` | number | Happiness score. |
| `neutral`   | number | Neutral score.   |
| `not_sure`  | number | Not sure score.  |

**Example Request**

```
GET /single-feature-api/meeting/meeting-emotions?file-hash=abcdef1234567890
Authorization: Bearer <JWT_token>
```

**Example Response**

```json
{
  "meeting_emotions": {
    "anger": 32.3,
    "disgust": 17.3,
    "fear": 2.6,
    "happiness": 1,
    "neutral": 29.3,
    "not_sure": 17.5
  }
}
```

#### Error Responses

| HTTP Status Code | Description        | Schema         |
| ---------------- | ------------------ | -------------- |
| 400              | Bad request.       | UploadError400 |
| 401              | Unauthorized.      | UploadError401 |
| 404              | Meeting not found. | -              |

**UploadError400 (schema)**

| Property  | Type   | Description    |
| --------- | ------ | -------------- |
| `message` | string | Error message. |

**UploadError401 (schema)**

| Property  | Type   | Description    |
| --------- | ------ | -------------- |
| `message` | string | Error message. |

### Conclusion

This concludes the documentation for the Meetra AI API's meeting emotions feature. You can use this endpoint to retrieve the emotions score for a processed meeting, providing the necessary authentication and meeting recording details.