---
title: "List Profiles"
method: GET
path: "/profiles"
tags: ["Profiles"]
---

# List Profiles

`GET /profiles`

## Request

- Base URL: `https://api.browser-use.com/api/v4`
- URL: `https://api.browser-use.com/api/v4/profiles`
- Auth: API key in header `X-Browser-Use-API-Key`

Get paginated list of profiles.

Use the `query` parameter to search profiles by name or user_id.
This is useful when you have many profiles and need to find a specific user.

Example: If you set `user_id` to your internal user identifier when creating profiles,
you can later search for that user by passing their identifier as the `query` parameter.

## Query parameters

- `pageSize` integer
- `pageNumber` integer
- `query` string, nullable

## Response `200`

Successful Response

- ProfileListResponse: Response model for paginated profile list requests.
  - `items` ProfileView[], required: List of profile views for the current page
    - `id` string, uuid, required: Unique identifier for the profile
    - `userId` string, nullable: Your internal user identifier for this profile. Use this to associate a profile with a user in your system.
    - `name` string, nullable: Optional name for the profile
    - `lastUsedAt` string, date-time, nullable: Timestamp when the profile was last used
    - `createdAt` string, date-time, required: Timestamp when the profile was created
    - `updatedAt` string, date-time, required: Timestamp when the profile was last updated
    - `cookieDomains` string[], nullable: List of domain URLs that have cookies stored for this profile
  - `totalItems` integer, required: Total number of items in the list
  - `pageNumber` integer, required: Page number
  - `pageSize` integer, required: Number of items per page

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/browser-use/apis/browser-use-public-api-v4.md) · [All operations](https://skmtc.dev/browser-use/apis/browser-use-public-api-v4/llms.txt) · [OpenAPI document](https://skmtc.dev/browser-use/apis/browser-use-public-api-v4/revisions/cd7b1eee1102?raw)