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

# List profiles

> List saved profiles. This endpoint returns a JSON array at the top level. One-time sessions are listed through active sessions instead.



## OpenAPI

````yaml /api-reference/openapi.json get /profiles
openapi: 3.1.0
info:
  title: Surfsky API
  version: 0.1.0
  description: >-
    Start cloud browsers, control them through CDP, and manage the profiles,
    proxies, and fingerprints they run with.
servers:
  - url: '{baseUrl}'
    variables:
      baseUrl:
        default: https://YOUR_API_HOST
        description: API base URL from your Surfsky dashboard, including https://.
security:
  - ApiToken: []
tags:
  - name: profiles
    description: >-
      Start, stop, and manage browsers. A one-time profile is discarded when it
      stops; a persistent profile keeps its cookies, storage, and fingerprint
      according to its storage settings.
  - name: proxies
    description: >-
      Look up what the premium and shared pools can offer before you pin a
      location, and read your traffic quota.
  - name: fingerprints
    description: >-
      The value sets a fingerprint field accepts. Use these to pin a renderer,
      screen, or device model instead of guessing at a string.
  - name: extensions
    description: Upload Chrome extensions once and load them into any browser you start.
  - name: captcha
    description: Balance on the CAPTCHA solver behind your account.
paths:
  /profiles:
    get:
      tags:
        - profiles
      summary: List profiles
      description: >-
        List saved profiles. This endpoint returns a JSON array at the top
        level. One-time sessions are listed through active sessions instead.
      operationId: profiles_list_profiles_get
      parameters:
        - name: page
          in: query
          required: false
          schema:
            type: integer
            default: 0
            title: Page
        - name: page_len
          in: query
          required: false
          schema:
            type: integer
            default: 100
            title: Page Len
        - name: ordering
          in: query
          required: false
          schema:
            enum:
              - created
              - '-created'
              - active
              - '-active'
              - title
              - '-title'
            type: string
            default: active
            title: Ordering
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                type: array
                items:
                  $ref: '#/components/schemas/ProfileOut'
                title: Response Profiles List Profiles Get
        '401':
          description: Missing or invalid API token
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiError'
        '403':
          description: Account or feature access denied
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiError'
        '422':
          description: Request validation failed
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiError'
        '429':
          description: Request, browser, session, or traffic limit reached; inspect code
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiError'
components:
  schemas:
    ProfileOut:
      properties:
        uuid:
          type: string
          title: Uuid
        title:
          type: string
          title: Title
        description:
          type: string
          title: Description
        proxy:
          anyOf:
            - type: string
              minLength: 1
              format: uri
            - type: 'null'
          title: Proxy
        status:
          type: string
          enum:
            - started
            - stopped
          title: Status
      type: object
      required:
        - uuid
        - title
        - description
        - proxy
        - status
      title: ProfileOut
    ApiError:
      type: object
      properties:
        success:
          type: boolean
          const: false
        msg:
          type: string
        code:
          type: string
        data: {}
        detail: {}
        error: {}
      description: >-
        Error fields vary for forwarded responses. Check HTTP status and code
        when present.
  securitySchemes:
    ApiToken:
      type: apiKey
      in: header
      name: X-Cloud-Api-Token
      description: API token from your dashboard.

````