Get bot details
Get comprehensive information about a specific bot.
Returns detailed bot information including current status, configuration, meeting metadata, and presigned URLs for all artifacts (video, audio, transcription, diarization). Artifact URLs are valid for 4 hours from the time of request. Returns null for artifacts if the bot's data has been deleted.
Artifact URLs: All artifact URLs (video, audio, transcription, diarization) are presigned URLs that expire after 4 hours. If the bot's data has been deleted (via the delete-data endpoint or data retention policy), these fields will be null. The artifacts_deleted field indicates whether the bot's data has been permanently removed.
Status Information: The response includes the bot's current status (status field) and timestamps for key events (joined_at, exited_at, created_at). If the bot failed, the response includes error_code and error_message fields with details about what went wrong.
Meeting Metadata: Includes meeting platform, meeting URL, participants list, speakers list, and meeting duration (if available). Some metadata may be null if the bot failed before joining or if the information is not available.
Transcription Information: If transcription was enabled, the response includes transcription provider, transcription IDs (for BYOK providers), and URLs to raw and processed transcription files.
Returns 404 if the bot is not found or does not belong to your team.
Authorization
ApiKeyAuth Your Meeting BaaS API key. Get one from your account settings.
In: header
Path Parameters
The UUID of the bot to get details for.
^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$uuidResponse Body
application/json
application/json
application/json
application/json
application/json
curl -X GET "https://api.meetingbaas.com/v2/bots/497f6eca-6276-4993-bfeb-53cbbbba6f08"{
"success": true,
"data": {
"bot_id": "41900e0f-e27a-4863-8321-478ccf15bbd8",
"bot_name": "string",
"meeting_url": "http://example.com",
"meeting_platform": "zoom",
"recording_mode": "audio_only",
"status": "queued",
"created_at": "2019-08-24T14:15:22Z",
"joined_at": "2019-08-24T14:15:22Z",
"exited_at": "2019-08-24T14:15:22Z",
"duration_seconds": 0,
"participants": [
{
"name": "string",
"id": -9007199254740991,
"display_name": "string",
"profile_picture": "http://example.com"
}
],
"speakers": [
{
"name": "string",
"id": -9007199254740991,
"display_name": "string",
"profile_picture": "http://example.com"
}
],
"artifacts_deleted": true,
"video": "http://example.com",
"audio": "http://example.com",
"diarization": "http://example.com",
"raw_transcription": "http://example.com",
"transcription": "http://example.com",
"chat_messages": "http://example.com",
"transcription_ids": [
"string"
],
"transcription_provider": "gladia",
"error_code": "string",
"error_message": "string",
"tokens": {
"recording": 0,
"transcription": 0,
"byok_transcription": 0,
"streaming_input": 0,
"streaming_output": 0,
"total": 0
},
"extra": {
"property1": null,
"property2": null
},
"zoom_config": {
"credential_id": "13c40afa-2996-4a0c-b2e9-68fba9462242",
"credential_user_id": "string",
"obf_token_url": "string",
"zak_token_url": "string"
}
}
}{
"success": false,
"error": "string",
"code": "string",
"statusCode": 9007199254740991,
"message": "string"
}{
"success": false,
"error": "string",
"code": "string",
"statusCode": 9007199254740991,
"message": "string",
"details": "string"
}{
"success": false,
"error": "string",
"code": "string",
"statusCode": 9007199254740991,
"message": "string",
"details": "string",
"retryAfter": 9007199254740991
}{
"success": false,
"error": "string",
"code": "string",
"statusCode": 9007199254740991,
"message": "string",
"details": "string"
}