Skip to main content
GET
/
v1
/
agents
List Agents
curl --request GET \
  --url https://api.browserbase.com/v1/agents \
  --header 'X-BB-API-Key: <api-key>'
{
  "data": [
    {
      "agentId": "<string>",
      "name": "<string>",
      "createdAt": "2023-11-07T05:31:56Z",
      "updatedAt": "2023-11-07T05:31:56Z",
      "systemPrompt": "<string>",
      "resultSchema": {}
    }
  ],
  "limit": 123,
  "nextCursor": "<string>"
}

Authorizations

​
X-BB-API-Key
string
header
required

Your Browserbase API Key.

Query Parameters

​
startAt
string<date-time>

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

​
endAt
string<date-time>

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

​
limit
integer
default:20

Maximum number of results to return.

Required range: 1 <= x <= 1000
​
cursor
string

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

Response

200 - application/json

The page of matching agents.

A page of agents.

​
data
object[]
required

The page of matching agents.

​
limit
integer
required

The maximum number of results returned in this page.

​
nextCursor
string
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.