> ## Documentation Index
> Fetch the complete documentation index at: https://docs.meshbrow.dev/llms.txt
> Use this file to discover all available pages before exploring further.

# List Profiles

> List all session profiles

# List Profiles

Retrieve all profiles for the authenticated account.

<ParamField query="tag" type="string">
  Filter by tag.
</ParamField>

<ParamField query="limit" type="integer" default="20">
  Maximum results (1-100).
</ParamField>

## Request

```bash theme={null}
curl "https://api.meshbrow.dev/v1/profiles?tag=scraping" \
  -H "Authorization: Bearer mb_live_..."
```

## Response

```json 200 theme={null}
{
  "items": [
    {
      "id": "prof_x9y8z7w6",
      "name": "GitHub Bot",
      "tags": ["github", "scraping"],
      "cookieCount": 24,
      "lastUsedAt": "2026-10-28T09:15:00Z",
      "usageCount": 47
    },
    {
      "id": "prof_a1b2c3d4",
      "name": "LinkedIn Scraper",
      "tags": ["linkedin", "scraping"],
      "cookieCount": 18,
      "lastUsedAt": "2026-10-27T16:30:00Z",
      "usageCount": 12
    }
  ],
  "hasMore": false,
  "total": 2
}
```