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

# List browser profiles

`GET /org/browser/profiles`

## Request

- Base URL: `https://api.context.dev/v1`
- URL: `https://api.context.dev/v1/org/browser/profiles`
- Auth: HTTP bearer

List the browser profiles your organization created with `/web/scrape`, newest first.

## Query parameters

- `limit` integer: Number of profiles per page.
- `cursor` string: The `next_cursor` from the previous page.

## Response `200`

A page of browser profiles

- ListProfilesResponse
  - `data` BrowserProfile[], required: Browser profiles, newest first.
    - `id` string, required: Profile ID to pass as `sharedParams.profile.profileId` on `/web/scrape`.
    - `description` string, nullable, required: The description supplied when the profile was created, or null.
    - `created_at` string, date-time, required: When the profile was created.
  - `has_more` boolean, required: Whether a next page exists.
  - `next_cursor` string, nullable, required: Pass as `cursor` to fetch the next page.
  - `key_metadata` KeyMetadata: Credits this request used and your remaining balance.
    - `credits_consumed` integer, required: Credits charged for this request.
    - `credits_remaining` integer, required: Credits remaining for your organization.
  - `request_id` string, uuid, required: Unique ID of this request, also in `X-Request-Id`. Include it when contacting support.

## Other responses

- `400`: Bad request
- `401`: Unauthorized
- `429`: Rate limit exceeded (60 requests per minute per organization).

## Changes

- **2026-10-21** `61627728926b`: 3 warning
  - added the new `NO_PUBLISHED_MARKDOWN` enum value to the `error_code` response property for the response status `400`
  - added the new `NO_PUBLISHED_MARKDOWN` enum value to the `error_code` response property for the response status `401`
  - added the new `NO_PUBLISHED_MARKDOWN` enum value to the `error_code` response property for the response status `429`
- **2026-10-19** `4ddcf49b9fe5`: 3 info
  - added the optional property `error_data` to the response with the `400` status
  - added the optional property `error_data` to the response with the `401` status
  - added the optional property `error_data` to the response with the `429` status
- **2026-10-16** `2125f3e94e52`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/context/apis/brand-api/changes/org/browser/profiles/get.md)

---

[API](https://skmtc.dev/context/apis/brand-api.md) · [All operations](https://skmtc.dev/context/apis/brand-api/llms.txt) · [OpenAPI document](https://skmtc.dev/context/apis/brand-api/revisions/9e2ab7841fb1?raw)