# Conversational Energy

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

**Endpoint:**

`/single-feature-api/meeting/meeting-energy`

**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 energy score successfully retrieved. | Meeting\_energy |
| 400              | Bad request.                                 | UploadError400  |
| 401              | Unauthorized.                                | UploadError401  |
| 404              | Meeting not found.                           | -               |

**Meeting\_energy (schema)**

| Property         | Type   | Description           |
| ---------------- | ------ | --------------------- |
| `meeting_energy` | number | Meeting energy score. |

**Example Request**

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

**Example Response**

```json
{
  "meeting_energy": 35
}
```

#### 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. |