---
title: "List Veilus browser profiles, with their running state; a running profile carries `cdpUrl`, and `headless: true` when it runs without a window."
method: GET
path: "/v1/profiles"
---

# List Veilus browser profiles, with their running state; a running profile carries \`cdpUrl\`, and \`headless: true\` when it runs without a window.

`GET /v1/profiles`

## Request

- Base URL: `http://127.0.0.1:10108`
- URL: `http://127.0.0.1:10108/v1/profiles`
- Auth: HTTP bearer

Lists every browser profile on this machine with its live running state, proxy host and port, tags and variable names. Variable values and proxy passwords are never returned. A running profile also carries `cdpUrl`, the DevTools endpoint any CDP client can drive it through.

## Response `200`

Every profile, with its live running state.

- object[]
  - `cdpUrl` string
  - `contentDataset` string
  - `createdAt` string, date-time, required
  - `folder` string, nullable, required
  - `groups` string[], required
  - `headless` unknown
  - `id` string, uuid, required
  - `identityDataset` string
  - `lastUsed` string, date-time, nullable, required
  - `name` string, required
  - `os` string, required
  - `proxy` object, required
    - `enabled` boolean, required
    - `host` string, required
    - `port` integer, required
    - `proxyType` 'http' | 'socks5' | 'residential', required
    - `requiresAuth` boolean, required
  - `proxyPoolId` string, uuid
  - `slug` string, required
  - `status` 'stopped' | 'starting' | 'running' | 'crashed', required
  - `tags` string[], required
  - `variableNames` string[], required

## Other responses

- `401`: No bearer token, or not a token this app issued. The body is empty: it never says which.
- `403`: Refused by the plan: it no longer includes the local API (checked on every request), or it does not allow this action (profile or schedule limit, parallel runs). A request whose Host header is not loopback is also 403, with an empty body.
- `500`: Veilus failed: storage could not be read or written, or a task panicked. The message says what failed; retrying rarely helps.

---

[API](https://skmtc.dev/veilus/apis/veilus-local-api.md) · [All operations](https://skmtc.dev/veilus/apis/veilus-local-api/llms.txt) · [OpenAPI document](https://skmtc.dev/veilus/apis/veilus-local-api/revisions/67ac3818f9d2?raw)