Getting Started

Learn how to integrate with the Wave Developer API to access your session data programmatically.

Overview

The Wave API provides programmatic access to your session data, including:

• Session metadata (title, duration, type, platform)
• AI-generated summaries and notes
• Full transcripts with speaker attribution
• Semantic search across all your sessions

Base URL

Quick Start

1. Create an API Token

Visit app.wave.co/settings/developer-api to create a new API token. Choose the permissions (scopes) your application needs:

• sessions:read - List sessions and view metadata/summaries
• transcripts:read - Access full session transcripts
• sessions:search - Perform semantic search queries

2. Make Your First Request

Include your token in the Authorization header:

curl -H "Authorization: Bearer wave_api_xxx..." \
  https://api.wave.co/v1/sessions

3. Handle the Response

API responses are returned as JSON:

{
  "sessions": [
    {
      "id": "abc123",
      "title": "Weekly Standup",
      "timestamp": "2025-01-20T10:00:00Z",
      "duration_seconds": 1800,
      "type": "meeting",
      "platform": "zoom"
    }
  ],
  "next_cursor": "2025-01-19T09:00:00Z",
  "has_more": true
}

Rate Limits

The API has the following rate limits:

• 60 requests per minute
• 1,000 requests per day

Rate limit information is included in response headers:

X-RateLimit-Limit: 60
X-RateLimit-Remaining: 58
X-RateLimit-Reset: 1706000000

Next Steps