> For the complete documentation index, see [llms.txt](https://docs.meetra.ai/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.meetra.ai/meetra-ai-conversation-intelligence-api-reference/conversational-energy.md).

# Conversational Energy

Retrieve Energy Score from the Conversation

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