BRbrowserbase

List Agents

Changed on

List agents across your account. Supports filtering by creation time.

get/v1/agents

Request

  • Base URL
    https://api.browserbase.com
  • Auth
    API key in header X-BB-API-Key

Query parameters

startAtstring date-time

Only return agents created on or after this timestamp (inclusive). RFC 3339, e.g. 2026-01-19T00:00:00Z.

endAtstring date-time

Only return agents created on or before this timestamp (inclusive). RFC 3339, e.g. 2026-01-20T00:00:00Z.

limitinteger

Maximum number of results to return.

cursorstring

Pagination cursor. Pass the nextCursor from the previous response to fetch the next page. Omit to start from the first page.

Response

The page of matching agents.

limitinteger required

The maximum number of results returned in this page.

nextCursorstring nullable required

Cursor for the next page. Pass it back as cursor on the next request to continue paging. null when there are no more results.

Changes