# Speaker Key Points

#### URL

```
/single-feature-api/meeting/key-points
```

#### Method

```
GET
```

#### Description

This endpoint allows you to retrieve the list of key points stated by speakers in a processed meeting. Key points are important statements or highlights made by the speakers during the meeting.

#### Parameters

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

#### Responses

* **200**: Meeting key points successfully retrieved. Returns a JSON object containing the key points stated by speakers (`Key_point_model`).
* **400**: Bad request error.
* **401**: Unauthorized error.
* **404**: Meeting not found error.
* Other possible responses are not specified.

**Key\_point\_model**

This is the JSON response schema for the successful 200 response:

```json
{
  "key_points": {
    "<speaker_id>": ["<key_point_1>", "<key_point_2>", "..."],
    ...
  }
}
```

* `key_points`: An object where the keys are the speaker IDs and the values are arrays of key points stated by each speaker.

#### Example

**Request**

```
GET /single-feature-api/meeting/key-points?file-hash=<meeting_file_hash>
```

**Response**

```json
{
  "key_points": {
    "11eb454c-68d4-40f0-b965-0074bc0e688f": ["Key point 1", "Key point 2"],
    "582fc671-5b8b-498d-a09e-bfb53145b05a": ["Key point 3"],
    "637f9221-ab4a-46bb-979e-776ba541a407": ["Key point 4", "Key point 5"],
    "b01792fb-5097-46d7-b458-1d559a9b4978": ["Key point 6"]
  }
}
```

This example response shows the key points stated by different speakers in the processed meeting. Each speaker is identified by their speaker ID, and the key points are provided as an array of strings.


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.meetra.ai/meetra-ai-conversation-intelligence-api-reference/speaker-key-points.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.