# Introduction

> The Nabrah Notetaker REST API — record meetings, read transcripts, and pull structured notes into your own product.

The Nabrah API gives your own software the same view of a meeting that the dashboard has: the recording, the transcript, the structured summary, and the decisions and action items pulled out of it.

Everything speaks JSON over HTTPS. There is one base URL, one authentication scheme, and one response envelope, so a client written against any endpoint works against all of them.

**Tip: Issue a key and start**

Keys are self-service, from **Dashboard → Developers**. Choose read-only for anything that only reads — you can add a fuller key later without disturbing the first.

## Where to start

- {rocket} [Quickstart](/docs/api/quickstart) — Authenticate and read your first meeting in five minutes.
- {key} [Authentication](/docs/api/authentication) — How keys are issued, scoped, and rotated.
- {book} [Endpoint reference](/docs/api/reference) — Every resource, parameter, and response.

## The shape of every call

Requests go to one host, carry a bearer token, and come back wrapped in a `data` envelope. Errors use the same envelope with an `error` key instead.

```bash cURL
curl https://api-notetaker.nabrah.ai/ext/v1/recordings \
  -H "Authorization: Bearer $NABRAH_API_KEY"
```
```ts Node
const response = await fetch("https://api-notetaker.nabrah.ai/ext/v1/recordings", {
  headers: { Authorization: `Bearer ${process.env.NABRAH_API_KEY}` },
});

const { data } = await response.json();
```
```python Python
import os, requests

response = requests.get(
    "https://api-notetaker.nabrah.ai/ext/v1/recordings",
    headers={"Authorization": f"Bearer {os.environ['NABRAH_API_KEY']}"},
)

data = response.json()["data"]
```

## What you can build

- {zap} [Bots](/docs/api/bots) — Send the notetaker into a call that is happening now.
- {webhook} [Webhooks](/docs/api/webhooks) — Get told when a meeting finishes processing.
- {blocks} [Agents and MCP](/docs/api/mcp) — Let a model read and act on meetings directly.
- {terminal} [Errors](/docs/api/errors) — One error envelope, one set of codes.

## Built for agents too

These pages are written to be read by software as well as by people. Append `.md` to any documentation URL for the raw markdown, or start from the index at `/llms.txt`.

```bash
curl https://notetaker.nabrah.ai/llms.txt
curl https://notetaker.nabrah.ai/docs/api/authentication.md
```

**Tip**

The **Copy page** button at the top of every page copies the same markdown, and the menu beside it hands the page straight to ChatGPT or Claude.