# Get Bot

Retrieve information about a specific bot, including its current status,
transcript (if available), participants, and lifecycle events.

Endpoint: GET /bot/{id}
Version: v1
Security: bearerAuth

## Path parameters:

  - `id` (string, required)
    Bot ID

## Query parameters:

  - `with-speaker-events` (boolean)
    Include speaker events in participant data

## Response 200 fields (application/json):

  - `id` (string)
    Unique bot identifier

  - `status` (string)
    Current status of the bot
    Enum: "scheduled", "booting", "joining", "recording", "processing", "transcribing", "leaving", "finished", "not_admitted", "bot_detected", "auth_required", "invalid_credentials", "failed"

  - `stop_reason` (string,null)
    Reason why the bot stopped. Only present when status is finished or not_admitted.
Refer to the [Bot Lifecycle](/concepts/bot-lifecycle) documentation for details on available stop reason codes.
    Enum: "invalid_meeting_url", "waiting_room_timeout", "manually_stopped", "call_already_finished", "request_denied", "host_in_another_meeting", "meeting_ended", "last_person_detected", "silence_detection_triggered", "kicked"

  - `service` (string)
    Service the bot joined
    Enum: "gmeet", "teams", "zoom"

  - `scheduled_for` (string,null)
    When the bot is scheduled to join (for scheduled bots)

  - `stop_options` (object)
    Defined options when the bot should stop on certain conditions.

  - `stop_options.time_limit` (integer)
    Maximum time in minutes that the bot may be active. Hard limit is 4 hours (240 minutes).

  - `stop_options.waiting_room_timeout` (integer)
    Minutes the bot will wait in the meeting waiting room before stopping if it is not admitted.
> ⚠️ Charge Warning: Going beyond 10 minutes incurs charges for not admitted bots. Additional fees equal your base price * (waiting_room_timeout - 10). Refer to [your billing page](https://platform.skribby.io?to=billing) for current base pricing.

  - `stop_options.last_person_detection` (integer)
    Minimum time in minutes the bot will spent alone in the meeting (once everyone left) before the bot will stop. 0 disables this functionality.

  - `stop_options.silence_detection` (integer)
    Minimum time in minutes the bot will wait for any sounds before the bot will stop. This is useful for when there are other bots in the call and therefor the last_person_detection fails. 0 disables this functionality.

  - `bot_name` (string)
    Name of the bot in the meeting

  - `bot_avatar` (string,null)
    URL to bot avatar image

  - `meeting_url` (string)
    URL of the meeting

  - `webhook_url` (string,null)
    Webhook URL for receiving updates.
Refer to the [Webhooks](#webhooks) section for details on webhook format and available events.

  - `recording_url` (string,null)
    URL to download the recording

  - `recording_available_until` (string,null)
    When the recording will be automatically deleted

  - `websocket_url` (string,null)
    WebSocket URL for real-time transcription (realtime models only)

  - `websocket_read_only_url` (string,null)
    WebSocket URL for real-time transcription (realtime models only) - Only provides access to events, no actions.  
Useful if you want to use the websocket directly in your front-end without providing access to the user.

  - `websocket_audio_url` (string,null)
    WebSocket URL for receiving realtime audio data from the bot.
Only available when using a realtime model or when realtime_audio: true was set when creating the bot.
Audio is streamed as 16-bit PCM at 16kHz sample rate.

  - `video` (boolean)
    Whether video is recorded for this meeting

  - `lang` (string,null)
    Language specified when creating the bot

  - `detected_lang` (string,null)
    Language detected from the conversation (if supported by the model)

  - `transcript` (array)
    Array of transcript segments

  - `transcript.start` (number)
    Start time in seconds

  - `transcript.end` (number)
    End time in seconds

  - `transcript.speaker` (integer)
    Speaker ID

  - `transcript.speaker_name` (string,null)
    Name of the speaker (only available for transcription models which support speaker diarization).
This field is only present when we are confident we can link a specific participant to this speaker.
If no participant could be confidently linked to the speaker, this will be null and potential_speaker_names will be provided instead.

  - `transcript.potential_speaker_names` (array,null)
    Array of potential speaker matches with confidence scores. This field is only present when we cannot confidently
link a single participant to the speaker. If speaker_name is provided, this field will be null.

  - `transcript.potential_speaker_names.name` (string)
    Name of the potential speaker

  - `transcript.potential_speaker_names.confidence` (number)
    Confidence score for this speaker match

  - `transcript.confidence` (number)
    Confidence score for transcript accuracy

  - `transcript.transcript` (string)
    The transcribed text

  - `transcript.utterances` (array)
    Detailed utterance information (model-specific)

  - `transcription_model` (string)
    Model used for transcription

  - `participants` (array)
    List of meeting participants

  - `participants.name` (string)
    Participant's display name

  - `participants.avatar` (string,null)
    URL to participant's avatar

  - `participants.first_seen_at` (string)
    When participant was first detected

  - `participants.events` (array)
    Speaker events (if with-speaker-events=true)

  - `participants.events.type` (string)
    Type of speaker event
    Enum: "started-speaking", "stopped-speaking"

  - `participants.events.timestamp` (integer)
    Unix timestamp in milliseconds

  - `events` (array)
    List of bot lifecycle events

  - `events.event` (string)
    Type of event

  - `events.data` (object)
    Event data

  - `events.data.old_status` (string)

  - `events.data.new_status` (string)

  - `events.created_at` (string)
    When the event occurred

  - `profanity_filter` (boolean)
    Whether profanity filter was enabled

  - `custom_vocabulary` (array)
    Words or phrases provided when creating meeting bot for transcription model

  - `created_at` (string)
    When the bot was created

  - `finished_at` (string,null)
    When the bot finished

  - `time_limit` (integer,null)
    Use time_limit property in stop_options.

## Response 401 fields (application/json):

  - `message` (string)
    Error message

## Response 404 fields (application/json):

  - `message` (string)
    Error message