Meeting BaaSMeeting BaaS
MeetingBaas APIMeetingBaas API v2Typescript SDKMCP ServersSpeaking BotsTranscript SeekerSelf Hosting

List Bots with Metadata

Retrieves a paginated list of the user's bots with essential metadata, including IDs, names, and meeting details. Supports filtering, sorting, and advanced querying options.

GET
/bots/bots_with_metadata

Authorization

ApiKeyAuth
x-meeting-baas-api-key<token>

API key for authentication

In: header

Query Parameters

bot_name?|

Filter bots by name containing this string.

Performs a case-insensitive partial match on the bot's name. Useful for finding bots with specific naming conventions or to locate a particular bot when you don't have its ID.

Example: "Sales" would match "Sales Meeting", "Quarterly Sales", etc.

created_after?|

Filter bots created after this date (ISO format).

Limits results to bots created at or after the specified timestamp. Used for time-based filtering to find recent additions.

Format: ISO-8601 date-time string (YYYY-MM-DDThh:mm:ss) Example: "2023-05-01T00:00:00"

created_before?|

Filter bots created before this date (ISO format).

Limits results to bots created at or before the specified timestamp. Used for time-based filtering to exclude recent additions.

Format: ISO-8601 date-time string (YYYY-MM-DDThh:mm:ss) Example: "2023-05-31T23:59:59"

cursor?|

Cursor for pagination, obtained from previous response.

Used for retrieving the next set of results after a previous call. The cursor value is returned in the nextCursor field of responses that have additional results available.

Format: Base64-encoded string containing pagination metadata

ended_after?|

Filter bots ended after this date (ISO format).

Limits results to bots that ended at or after the specified timestamp. Useful for finding completed meetings within a specific time period.

Format: ISO-8601 date-time string (YYYY-MM-DDThh:mm:ss) Example: "2023-05-01T00:00:00"

filter_by_extra?|

Filter bots by matching values in the extra JSON payload.

This parameter performs in-memory filtering on the extra JSON field, similar to a SQL WHERE clause. It reduces the result set to only include bots that match all specified conditions.

Format specifications: - Single condition: "field:value" - Multiple conditions: "field1:value1,field2:value2"

Examples: - "customer_id:12345" - Only bots with this customer ID - "status:active,project:sales" - Only active bots from sales projects

Notes: - All conditions must match for a bot to be included - Values are matched exactly (case-sensitive) - Bots without the specified field are excluded

limit?integer

Maximum number of bots to return in a single request.

Limits the number of results returned in a single API call. This parameter helps control response size and page length.

Default: 10 Minimum: 1 Maximum: 50

Default10
Formatint32
meeting_url?|

Filter bots by meeting URL containing this string.

Performs a case-insensitive partial match on the bot's meeting URL. Use this to find bots associated with specific meeting platforms or particular meeting IDs.

Example: "zoom.us" would match all Zoom meetings

sort_by_extra?|

Sort the results by a field in the extra JSON payload.

This parameter performs in-memory sorting on the extra JSON field, similar to a SQL ORDER BY clause. It changes the order of results but not which results are included.

Format specifications: - Default (ascending): "field" - Explicit direction: "field:asc" or "field:desc"

Examples: - "customer_id" - Sort by customer_id (ascending) - "priority:desc" - Sort by priority (descending)

Notes: - Applied after all filtering - String comparison is used for sorting - Bots with the field come before bots without it - Can be combined with filter_by_extra

speaker_name?|

NOTE: this is a preview feature and not yet available

Filter bots by speaker name containing this string.

Performs a case-insensitive partial match on the speakers in the meeting. Useful for finding meetings that included a specific person.

Example: "John" would match meetings with speakers like "John Smith" or "John Doe"

Response Body

application/json

curl -X GET "https://api.meetingbaas.com/bots/bots_with_metadata"
{
  "bots": [
    {
      "access_count": 0,
      "bot_name": "string",
      "created_at": "string",
      "duration": 0,
      "ended_at": "string",
      "extra": {},
      "id": 0,
      "last_accessed_at": "string",
      "meeting_url": "string",
      "session_id": "string",
      "speakers": [
        "string"
      ],
      "uuid": "095be615-a8ad-4c33-8e9c-c7612fbf6c9f"
    }
  ],
  "last_updated": "2026-04-04T12:29:32.375074809+00:00",
  "next_cursor": "string"
}
Edit on GitHub