Scheduled Meetings

GET /meetings/{id}

Summary Retrieve details for a scheduled meeting notetaker by meeting id.
URL /api/v1/meetings/{id}
Request Headers
  • Authorization – Rev [ClientApiKey]:[UserAPIKey]
  • Accept – application/json (default) or application/xml
Response

On success, 200 OK with the scheduled meeting details.

FieldTypeDescription
idstringUnique meeting identifier.
join_urlstring (URL)Meeting join link.
scheduled_time_utcan ISO 8601 date-timeScheduled start time (UTC).
processing_statusstringCurrent processing status.
failure_reasonstringReason if scheduling/processing failed, if any.
notetaker_display_namestringDisplay name for the notetaker.
notetaker_requested_at_utcan ISO 8601 date-timeWhen a notetaker was requested, if applicable.
created_at_utcan ISO 8601 date-timeWhen the record was created.
live_transcription_urlstring (URL)When the meeting has started, a URL to view live transcription.
notetaker_status_changes array of status change objects Complete chronological history of notetaker status transitions throughout the meeting lifecycle. Useful for troubleshooting when the notetaker encounters issues joining or recording.

Each status change object contains:
  • code (string) – Current status code (e.g., "ready", "joining_call", "in_waiting_room", "recording", "call_ended")
  • sub_code (string, omitted if not applicable) – Specific reason or sub-status providing additional context when present (e.g., "bot_kicked_from_waiting_room", "host_ended_meeting")
  • description (string, omitted if empty) – Human-readable explanation of the status change, particularly useful when troubleshooting errors
  • created_at (string, ISO 8601 date-time) – UTC timestamp when this status change occurred
Error Responses
  • 404 Not Found – if no meeting is found for the given id.

Sample Success Response (JSON)

{
  "id": "507f1f77bcf86cd799439011",
  "join_url": "https://zoom.us/j/123456789?pwd=abc123",
  "scheduled_time_utc": "2025-01-15T16:30:00Z",
  "processing_status": "Queued",
  "process_at": "2025-01-15T16:25:00Z",
  "failure_reason": null,
  "notetaker_display_name": "Rev Notetaker",
  "notetaker_requested_at_utc": "2025-01-15T16:20:00Z",
  "created_at_utc": "2025-01-10T12:00:00Z",
  "retry_count": 0,
  "live_transcription_url": "https://www.rev.com/transcript-editor/liveMeetingTranscript?meetingId=TWVldGluZzoxMjM0NTY3ODk=",
  "notetaker_status_changes": [
    {
      "code": "ready",
      "created_at": "2025-01-15T16:25:34Z"
    },
    {
      "code": "joining_call",
      "created_at": "2025-01-15T16:30:42Z"
    },
    {
      "code": "in_waiting_room",
      "created_at": "2025-01-15T16:30:58Z"
    },
    {
      "code": "call_ended",
      "sub_code": "bot_kicked_from_waiting_room",
      "description": "The bot was removed from the waiting room by the host.",
      "created_at": "2025-01-15T16:31:13Z"
    }
  ]
}