Wave for Agents · API

The Wave Developer API

Read Wave recordings, transcripts, and summaries programmatically. Run semantic search across a user’s entire recording history. Token-based, scoped permissions, served at api.wave.co.

List & read sessionsIterate over a user's recordings with title, type, duration, timestamp, and platform. Fetch a single session for its full transcript, speaker_transcript, segments, and AI summary.
Retrieve transcriptsPull the verbatim transcript with speaker labels for any session. Use it to feed downstream summarization, translation, indexing, or your own analytics.
Semantic searchQuery a user's recording history with natural-language search powered by vector embeddings. Returns ranked sessions and snippet locations within them.

Authentication

Wave API tokens start with the prefix wave_api_. Tokens are scoped — pick from sessions:read, sessions:search, and transcripts:read so a token has access only to what it needs. Tokens are stored as SHA-256 hashes server-side — even Wave staff cannot recover a token after creation, so save it when you generate it.

Quick start

# List a user's sessions
curl https://api.wave.co/v1/sessions \
  -H "Authorization: Bearer wave_api_..."

# Fetch a single session with its transcript
curl https://api.wave.co/v1/sessions/SESSION_ID \
  -H "Authorization: Bearer wave_api_..."

# Semantic search across a user's recordings
curl -X POST https://api.wave.co/v1/search \
  -H "Authorization: Bearer wave_api_..." \
  -H "Content-Type: application/json" \
  -d '{"query": "decisions we made about pricing"}'

Three ways to use it

The Wave API is one of three developer surfaces, all sharing the same account and permissions:

Full reference docs are at api.wave.co.

Wave app screenshot showing meeting transcription
Wave AI note taker background pattern
Start today

Wave. Catch every word