API Documentation
Available on the Team plan. Create meetings, poll status, and download reports — programmatically.
Authentication
Create an API key in Account → API keys (Team plan required). The key is shown once — store it securely. Send it on every request:
Authorization: Bearer mmn_live_...
API usage draws from the same minute pool as the app, with the same plan limits. Keys can be revoked at any time from your account.
Create a meeting
Upload an audio or video file (MP3, MP4, WAV, WebM, M4A…) for transcription and notes.
POST https://www.mrmeetnote.com/api/meetings
Content-Type: multipart/form-data
curl -X POST "https://www.mrmeetnote.com/api/meetings" \
-H "Authorization: Bearer $MMN_KEY" \
-F "file=@standup.mp3" \
-F "output_language=en" \
-F "detail_level=standard"
# → { "job_id": 123, "status": "queued" }
| Field | Values |
|---|---|
| file | audio/video file (required) |
| output_language | ISO code for the notes language, e.g. en, ar, es (default en) |
| detail_level | concise | standard | detailed |
| force_language | optional — force the spoken-language hint instead of auto-detect |
Poll status / fetch notes
GET https://www.mrmeetnote.com/api/meetings/{job_id}
# processing → { "job_id": 123, "status": "processing", ... }
# done → { "job_id": 123, "status": "done", "notes": { ...structured notes... } }
List meetings
GET https://www.mrmeetnote.com/api/meetings
# → { "meetings": [ { "job_id", "status", "language", "detail_level", "created_at", ... } ] }
Download a report
GET https://www.mrmeetnote.com/api/meetings/{job_id}/report?format=pdf
GET https://www.mrmeetnote.com/api/meetings/{job_id}/report?format=docx×tamps=true
# → binary file (Content-Disposition: attachment)
Errors
| Status | Meaning |
|---|---|
| 401 | Missing or invalid API key |
| 402 | Plan limit — quota exceeded, meeting too long, or feature not in your plan. The JSON body includes details and, for quota, an overage quote. |
| 404 | Meeting not found (or not yours) |
| 409 | Notes not ready yet — keep polling |
| 413 | File exceeds the upload size cap |
Fair use
Poll status no more than once every few seconds per job. Keys are per-account; don't embed them in client-side code.