---
title: "List browser profiles"
method: GET
path: "/v1/browser_profiles"
tags: ["Browser Profiles"]
---

# List browser profiles

`GET /v1/browser_profiles`

Get all browser profiles for the organization

## Query parameters

- `page` integer
- `page_size` integer
- `include_deleted` boolean — Include deleted browser profiles
- `search_key` string, nullable — Case-insensitive substring search across: browser profile name and description. A profile is returned if either field matches.
- `managed` boolean, nullable — Omit to return all profiles; false returns only user-created profiles; true returns only auto-managed profiles.

## Headers

- `x-api-key` string, nullable — Skyvern API key for authentication. API key can be found at https://app.skyvern.com/settings.

## Response `200`

Successfully retrieved browser profiles

- BrowserProfile[]
  - `browser_profile_id` string, required
  - `organization_id` string, required
  - `name` string, required
  - `description` string, nullable
  - `source_browser_type` string, nullable
  - `proxy_location` union
    - 'RESIDENTIAL' | 'US-CA' | 'US-NY' | 'US-TX' | 'US-FL' | 'US-WA' | 'RESIDENTIAL_ES' | 'RESIDENTIAL_IE' | 'RESIDENTIAL_GB' | 'RESIDENTIAL_IN' | 'RESIDENTIAL_JP' | 'RESIDENTIAL_FR' | 'RESIDENTIAL_DE' | 'RESIDENTIAL_NZ' | 'RESIDENTIAL_ZA' | 'RESIDENTIAL_AR' | 'RESIDENTIAL_AU' | 'RESIDENTIAL_BR' | 'RESIDENTIAL_TR' | 'RESIDENTIAL_CA' | 'RESIDENTIAL_MX' | 'RESIDENTIAL_IT' | 'RESIDENTIAL_NL' | 'RESIDENTIAL_PH' | 'RESIDENTIAL_KR' | 'RESIDENTIAL_SA' | 'RESIDENTIAL_ISP' | 'NONE'
    - GeoTarget — Granular proxy geo-targeting request with country, optional subdivision, and optional city.
      - `country` string, required — ISO 3166-1 alpha-2 country code (e.g., 'US', 'GB', 'DE')
      - `subdivision` string, nullable — ISO 3166-2 subdivision code without country prefix (e.g., 'CA' for California, 'NY' for New York)
      - `city` string, nullable — City name in English from GeoNames (e.g., 'New York', 'Los Angeles', 'London')
    - object
  - `proxy_session_id` string, nullable
  - `is_managed` boolean
  - `workflow_permanent_id` string, nullable
  - `browser_profile_key_digest` string, nullable
  - `created_at` string, date-time, required
  - `modified_at` string, date-time, required
  - `deleted_at` string, date-time, nullable
  - `last_verified_login_at` string, date-time, nullable
  - `linked_credential_name` string, nullable

## Other responses

- `422` — Validation Error

## Changes

- **2026-07-24** `bd64e0480f0a` — 1 info
  - added the optional property `items/last_verified_login_at` to the response with the `200` status
- **2026-07-22** `5987635eae7d` — 1 info
  - added the optional property `items/linked_credential_name` to the response with the `200` status
- **2026-07-07** `fdc175c3bb8c` — 4 info
  - added the new optional `query` request parameter `managed`
  - added the optional property `items/browser_profile_key_digest` to the response with the `200` status
  - added the optional property `items/is_managed` to the response with the `200` status
  - added the optional property `items/workflow_permanent_id` to the response with the `200` status
- **2026-06-26** `9de266eb002a` — 2 info
  - added the optional property `items/proxy_location` to the response with the `200` status
  - added the optional property `items/proxy_session_id` to the response with the `200` status
- **2026-06-08** `3a3616091b66` — 2 breaking, 8 info
  - response property `items/deleted_at` list-of-types was widened by adding types `null` to media type `application/json` of response `200`
  - response property `items/description` list-of-types was widened by adding types `null` to media type `application/json` of response `200`
  - added the new optional `query` request parameter `page`
  - added the new optional `query` request parameter `page_size`
  - …6 more

[Full history](https://skmtc.dev/skyvern-ai/apis/skyvern-api-2/changes/v1/browser_profiles/get.md)

---

[API](https://skmtc.dev/skyvern-ai/apis/skyvern-api-2.md) · [All operations](https://skmtc.dev/skyvern-ai/apis/skyvern-api-2/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/skyvern-ai/skyvern-api-2/revisions/d9771d57ea65/schema)