# Search meetings

`GET /meeting.search`

## Description

AI-powered search across meeting transcripts and summaries.

**Access:** Personal access only. Organization (account-level) tokens are not supported.

**Required scope:** `meetings:read`

---

**OpenAPI Spec:** [chat-v1.json](https://developer.ro.am/chat-v1.json)

## Authentication

```
Authorization: Bearer YOUR_API_KEY
```

## Parameters

| Name | In | Type | Required | Description |
|------|-----|------|----------|-------------|
| `query` | query | string | Yes | Search query string. |
| `after` | query | string | No | Only return results from meetings after this date (YYYY-MM-DD). |
| `before` | query | string | No | Only return results from meetings before this date (YYYY-MM-DD). |
| `timezone` | query | string | No | Timezone for date interpretation (e.g. "America/New_York"). |

## Responses

### 200 - Search results retrieved successfully

| Property | Type | Required | Description |
|----------|------|----------|-------------|
| `results` | object[] | No |  |
| `inferredFilter` | object | No | AI-inferred search filters |
| `inferredQuery` | string | No | AI-refined search query |

**results** (array item):

| Property | Type | Required | Description |
|----------|------|----------|-------------|
| `meetingId` | string | No | Meeting ID |
| `meetingName` | string | No | Meeting title |
| `meetingDate` | string | No | Meeting date (RFC-3339) |
| `participants` | string[] | No | Participant names |
| `highlightedSummary` | string | No | Relevant summary excerpt |
| `highlightedTranscript` | string | No | Relevant transcript excerpt |

**inferredFilter**:

| Property | Type | Required | Description |
|----------|------|----------|-------------|
| `after` | string | No | Inferred start date (YYYY-MM-DD) |
| `before` | string | No | Inferred end date (YYYY-MM-DD) |
| `attendees` | string[] | No | Inferred attendee filter |


#### Example Response

```json
{
  "results": [
    {
      "meetingId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
      "meetingName": "Weekly Team Standup",
      "meetingDate": "2025-04-07T10:00:00Z",
      "participants": [
        "Alex Chen",
        "Jordan Smith"
      ],
      "highlightedSummary": "Discussed the **API documentation** updates for v1 endpoints",
      "highlightedTranscript": "...we need to add the meeting endpoints to the **API docs**..."
    }
  ]
}
```

### 400 - Bad request. Missing `query` parameter.

### 401 - Presented invalid authentication credentials.

### 403 - Organization (account-level) tokens are not supported. Use a personal access token.

### 405 - An unsupported method was requested.

### 500 - An internal error occurred.

---

*Machine-readable API documentation.*
*Full documentation: https://developer.ro.am/docs/api/meeting-search*