List Bots with Metadata

Paginated list of bots sorted by creation date (newest first).

Supports filtering by meeting_url, bot_name, created_after/before, and speaker_name.

Advanced JSON filtering with filter_by_extra: "field:value,field2:value2" and sorting with sort_by_extra: "field:desc".

Returns metadata with meeting details, duration, speakers, and pagination token in next_cursor.

Authorization

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

API key for authentication

In: header

Query Parameters

bot_namestring | null

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_afterstring | null

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_beforestring | null

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"

cursorstring | null

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

filter_by_extrastring | null

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

limitinteger

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

Default: 10Format: "int32"

meeting_urlstring | null

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_extrastring | null

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_namestring | null

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"

curl -X GET "https://api.meetingbaas.com/bots/bots_with_metadata?bot_name=string&created_after=string&created_before=string&cursor=string&filter_by_extra=string&meeting_url=string&sort_by_extra=string&speaker_name=string" \
  -H "x-meeting-baas-api-key: <token>"

{
  "last_updated": "string",
  "next_cursor": "string",
  "recent_bots": [
    {
      "access_count": 0,
      "content_deleted": true,
      "created_at": "string",
      "duration": 0,
      "ended_at": "string",
      "extra": {},
      "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
      "last_accessed_at": "string",
      "meeting_url": "string",
      "name": "string",
      "session_id": "string",
      "speakers": [
        "string"
      ]
    }
  ]
}

List Bots with Metadata

Authorization

Query Parameters

Response

TypeScript