> ## Documentation Index
> Fetch the complete documentation index at: https://api-docs.recnote.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Introduction

> Transcription and AI clinical-note generation as an API.

The Recnote API turns clinical conversation audio into structured journal
notes. You send audio (a complete recording or a stream of chunks), optionally
together with metadata that shapes the output — template structure, language,
profession context — and you get back a structured note as JSON, ready to
render in your own UI or EHR.

The API is fully synchronous: every request returns its result in the HTTP
response. There is no dashboard dependency and no callback to wait for.

## What you can do:

<CardGroup cols={2}>
  <Card title="Transcribe audio" icon="waveform">
    Submit a recording and get the transcript back. Single file or chunked.
  </Card>

  <Card title="Generate clinical notes" icon="file-lines">
    Produce a structured SOAP-style note from audio or from a transcript you
    already have.
  </Card>

  <Card title="Bring your own template" icon="table-list">
    Pass a template structure and the note is generated to match your sections.
  </Card>

  <Card title="Multilingual" icon="language">
    Swedish, English, Finnish, Norwegian, Danish, German, Turkish, Arabic.
  </Card>
</CardGroup>

## Two integration modes

1. **One-shot.** You have the full recording. `POST /api/v1/notes` with the
   audio file → transcript + generated note in one response.
2. **Chunked.** You stream audio while the consultation is ongoing. Open a
   session, push chunks as they arrive, then ask for the note when done.

Both modes accept the same metadata and return the same note shape.

## Base URL

```
https://api.recnote.ai
```

## Response shape

A generated note is returned as a JSON object with the clinical sections
(reason for visit, subjective, objective, assessment, plan), suggested
diagnosis/procedure codes, a combined rendering, and optional tasks. You map
these into your own UI however suits your product. See
[Generate notes](/api/notes) for the full schema.