Login PageSign Up
API Reference

List Bots

get
https://us-east-1.recall.ai/api/v1/bot/

Get a list of all bots

The base rate limit for this endpoint is:

  • 60 requests per min per workspace
Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…

Use this endpoint to:

  • Get a list of bots in your workspace for dashboards, audits, exports, or admin tooling.
  • Find bots scheduled in a specific time window, such as bots joining today or in the next hour.
  • Look up bots by bot status, for a specific meeting, or filtering on custom bot metadata.
📘

Bot status change events

To track bot lifecycle/status changes, listen for bot status change webhook events. Do not poll the API for bot status changes. Polling for bot status changes is an anti-pattern and must not be used in production integrations.

Bot status change events are delivered through the webhook configured in the Recall webhook dashboard. They cannot be subscribed to through recording_config.realtime_endpoints.

See Status Change Webhooks for setup and verification details, and Bot Webhooks for the list of available bot status changes.
Query Params
date
date
string
string

Filter by metadata. Replace with the metadata key you want to filter on.

integer

A page number within the paginated result set.

platform
array of strings
  • zoom - Zoom
  • google_meet - Meet
  • goto_meeting - Goto
  • microsoft_teams - Teams
  • microsoft_teams_live - Teams Live
  • webex - Webex
  • chime_sdk - Chime Sdk
  • zoom_rtms - Zoom Rtms
  • google_meet_media_api - Google Meet Media Api
  • slack_authenticator - Slack Authenticator
  • slack_huddle_observer - Slack Huddle Observer
platform
status
array of strings
  • ready - Ready
  • joining_call - Joining Call
  • in_waiting_room - In Waiting Room
  • in_call_not_recording - In Call Not Recording
  • recording_permission_allowed - Recording Permission Allowed
  • recording_permission_denied - Recording Permission Denied
  • in_call_recording - In Call Recording
  • recording_done - Recording Done
  • call_ended - Call Ended
  • done - Done
  • fatal - Fatal
  • media_expired - Media Expired
  • analysis_done - Analysis Done
  • analysis_failed - Analysis Failed
status
string

When present, uses cursor-based pagination instead of offset pagination.

Responses

400

No response body

404

No response body

Updated about 2 months ago

Language
Credentials
Header
URL
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json

Updated about 2 months ago