> ## Documentation Index > Fetch the complete documentation index at: https://floppydata.com/docs/llms.txt > Use this file to discover all available pages before exploring further. # List Sessions > Lists browser session history using cursor pagination. Session history is newest first. Filter by `status`, use the opaque `nextCursor` unchanged, and use each item’s `settings.id` when you want to restore saved browser identity and state. ## OpenAPI ````yaml api-reference/openapi.json GET /v2/browser/sessions openapi: 3.1.0 info: title: Floppydata Client API description: >- Client API v2 for Web Data, proxy products, proxy tools, and account rollups. You can manage your API keys in [API keys](https://app.floppydata.com/api-keys). version: 2.0.0 servers: - url: https://api.floppydata.net description: Production security: - apiKeyHeader: [] tags: - name: Web Data description: Fetch pages and inspect Web Data balance and usage. - name: Proxy description: Proxy tools shared across proxy products. - name: Rotating Proxy description: Rotating proxy subusers, connections, locations, balance, and usage. - name: Static Proxy description: Static proxy inventory for the authenticated account. - name: Account description: Account-level balance and usage rollups across available products. - name: Cloud Browser description: |- Session-first cloud browsers with persistent settings under the hood. Create a session, connect using the returned WebSocket URL, then navigate with Playwright or Puppeteer. Reuse settings.id to restore the same identity and browser state. paths: /v2/browser/sessions: get: tags: - Cloud Browser summary: List browser sessions description: Lists browser session history using cursor pagination. operationId: listBrowserSessions parameters: - in: query name: status schema: type: string enum: - running - stopped - timedOut - failed - in: query name: cursor schema: type: string minLength: 1 - in: query name: limit schema: default: 20 type: integer minimum: 1 maximum: 100 responses: '200': description: Browser session history. content: application/json: schema: type: object properties: items: type: array items: type: object properties: id: type: string format: uuid pattern: >- ^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$ status: type: string enum: - running - stopped - timedOut - failed connectUrl: anyOf: - type: string - type: 'null' settings: type: object properties: id: type: string format: uuid pattern: >- ^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$ required: - id additionalProperties: false runtime: type: object properties: timeoutSeconds: default: 600 type: integer minimum: 60 maximum: 21600 keepAlive: default: false type: boolean additionalProperties: false metadata: type: object propertyNames: type: string additionalProperties: {} createdAt: type: string startedAt: anyOf: - type: string - type: 'null' expiresAt: type: string endedAt: anyOf: - type: string - type: 'null' required: - id - status - connectUrl - settings - runtime - createdAt - startedAt - expiresAt - endedAt additionalProperties: false example: id: 58e531ee-16ca-49d0-8722-b425d154cc10 status: running connectUrl: >- wss://api.floppydata.net/v2/browser/sessions/58e531ee-16ca-49d0-8722-b425d154cc10/connect?token=SIGNED_TOKEN settings: id: f742823c-7ba6-4488-a72d-6e9c5447eacb runtime: timeoutSeconds: 1800 keepAlive: true metadata: taskId: checkout-42 createdAt: '2026-07-10T12:00:00Z' startedAt: '2026-07-10T12:00:01Z' expiresAt: '2026-07-10T12:30:00Z' endedAt: null nextCursor: anyOf: - type: string - type: 'null' required: - items - nextCursor additionalProperties: false '400': description: The request body or query parameters are invalid. content: application/json: schema: type: object properties: error: type: object properties: code: type: string enum: - unauthorized - forbidden - invalid_request - insufficient_balance - account_not_configured - not_found - settings_in_use - settings_limit_reached - session_not_active - connection_in_use - upstream_error - internal_error message: type: string example: Invalid request parameters. details: type: object properties: target: example: settings.id type: string recoveryHint: example: >- Stop the active session before reusing these settings. type: string activeSessionId: example: 58e531ee-16ca-49d0-8722-b425d154cc10 type: string format: uuid pattern: >- ^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$ nextOperationId: example: stopBrowserSession type: string requestId: example: a1901a29e82a999f-CDG type: string upstreamStatus: example: 503 type: integer minimum: 100 maximum: 599 failureStage: example: provider_browser_start type: string diagnosticCode: example: token_sign_failed type: string additionalProperties: {} required: - code - message - details required: - error example: error: code: invalid_request message: Invalid request parameters. details: issues: - path: country code: invalid_format message: Expected a 2-letter country code. '401': description: The API key is missing, invalid, or expired. content: application/json: schema: type: object properties: error: type: object properties: code: type: string enum: - unauthorized - forbidden - invalid_request - insufficient_balance - account_not_configured - not_found - settings_in_use - settings_limit_reached - session_not_active - connection_in_use - upstream_error - internal_error message: type: string example: Invalid request parameters. details: type: object properties: target: example: settings.id type: string recoveryHint: example: >- Stop the active session before reusing these settings. type: string activeSessionId: example: 58e531ee-16ca-49d0-8722-b425d154cc10 type: string format: uuid pattern: >- ^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$ nextOperationId: example: stopBrowserSession type: string requestId: example: a1901a29e82a999f-CDG type: string upstreamStatus: example: 503 type: integer minimum: 100 maximum: 599 failureStage: example: provider_browser_start type: string diagnosticCode: example: token_sign_failed type: string additionalProperties: {} required: - code - message - details required: - error example: error: code: unauthorized message: Unauthorized details: {} '402': description: The account does not have enough balance for this request. content: application/json: schema: type: object properties: error: type: object properties: code: type: string enum: - unauthorized - forbidden - invalid_request - insufficient_balance - account_not_configured - not_found - settings_in_use - settings_limit_reached - session_not_active - connection_in_use - upstream_error - internal_error message: type: string example: Invalid request parameters. details: type: object properties: target: example: settings.id type: string recoveryHint: example: >- Stop the active session before reusing these settings. type: string activeSessionId: example: 58e531ee-16ca-49d0-8722-b425d154cc10 type: string format: uuid pattern: >- ^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$ nextOperationId: example: stopBrowserSession type: string requestId: example: a1901a29e82a999f-CDG type: string upstreamStatus: example: 503 type: integer minimum: 100 maximum: 599 failureStage: example: provider_browser_start type: string diagnosticCode: example: token_sign_failed type: string additionalProperties: {} required: - code - message - details required: - error example: error: code: insufficient_balance message: Insufficient proxy traffic balance. details: {} '403': description: The API key does not grant access to this operation. content: application/json: schema: type: object properties: error: type: object properties: code: type: string enum: - unauthorized - forbidden - invalid_request - insufficient_balance - account_not_configured - not_found - settings_in_use - settings_limit_reached - session_not_active - connection_in_use - upstream_error - internal_error message: type: string example: Invalid request parameters. details: type: object properties: target: example: settings.id type: string recoveryHint: example: >- Stop the active session before reusing these settings. type: string activeSessionId: example: 58e531ee-16ca-49d0-8722-b425d154cc10 type: string format: uuid pattern: >- ^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$ nextOperationId: example: stopBrowserSession type: string requestId: example: a1901a29e82a999f-CDG type: string upstreamStatus: example: 503 type: integer minimum: 100 maximum: 599 failureStage: example: provider_browser_start type: string diagnosticCode: example: token_sign_failed type: string additionalProperties: {} required: - code - message - details required: - error example: error: code: forbidden message: Forbidden details: {} '404': description: The requested resource is not available. content: application/json: schema: type: object properties: error: type: object properties: code: type: string enum: - unauthorized - forbidden - invalid_request - insufficient_balance - account_not_configured - not_found - settings_in_use - settings_limit_reached - session_not_active - connection_in_use - upstream_error - internal_error message: type: string example: Invalid request parameters. details: type: object properties: target: example: settings.id type: string recoveryHint: example: >- Stop the active session before reusing these settings. type: string activeSessionId: example: 58e531ee-16ca-49d0-8722-b425d154cc10 type: string format: uuid pattern: >- ^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$ nextOperationId: example: stopBrowserSession type: string requestId: example: a1901a29e82a999f-CDG type: string upstreamStatus: example: 503 type: integer minimum: 100 maximum: 599 failureStage: example: provider_browser_start type: string diagnosticCode: example: token_sign_failed type: string additionalProperties: {} required: - code - message - details required: - error example: error: code: not_found message: Rotating proxy credential was not found. details: {} '409': description: The authenticated account is not configured for this product. content: application/json: schema: type: object properties: error: type: object properties: code: type: string enum: - unauthorized - forbidden - invalid_request - insufficient_balance - account_not_configured - not_found - settings_in_use - settings_limit_reached - session_not_active - connection_in_use - upstream_error - internal_error message: type: string example: Invalid request parameters. details: type: object properties: target: example: settings.id type: string recoveryHint: example: >- Stop the active session before reusing these settings. type: string activeSessionId: example: 58e531ee-16ca-49d0-8722-b425d154cc10 type: string format: uuid pattern: >- ^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$ nextOperationId: example: stopBrowserSession type: string requestId: example: a1901a29e82a999f-CDG type: string upstreamStatus: example: 503 type: integer minimum: 100 maximum: 599 failureStage: example: provider_browser_start type: string diagnosticCode: example: token_sign_failed type: string additionalProperties: {} required: - code - message - details required: - error example: error: code: account_not_configured message: Account is not configured for proxy products. details: {} '500': description: An unexpected server error occurred. content: application/json: schema: type: object properties: error: type: object properties: code: type: string enum: - unauthorized - forbidden - invalid_request - insufficient_balance - account_not_configured - not_found - settings_in_use - settings_limit_reached - session_not_active - connection_in_use - upstream_error - internal_error message: type: string example: Invalid request parameters. details: type: object properties: target: example: settings.id type: string recoveryHint: example: >- Stop the active session before reusing these settings. type: string activeSessionId: example: 58e531ee-16ca-49d0-8722-b425d154cc10 type: string format: uuid pattern: >- ^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$ nextOperationId: example: stopBrowserSession type: string requestId: example: a1901a29e82a999f-CDG type: string upstreamStatus: example: 503 type: integer minimum: 100 maximum: 599 failureStage: example: provider_browser_start type: string diagnosticCode: example: token_sign_failed type: string additionalProperties: {} required: - code - message - details required: - error example: error: code: internal_error message: Internal Server Error details: {} '502': description: An upstream service failed while processing the request. content: application/json: schema: type: object properties: error: type: object properties: code: type: string enum: - unauthorized - forbidden - invalid_request - insufficient_balance - account_not_configured - not_found - settings_in_use - settings_limit_reached - session_not_active - connection_in_use - upstream_error - internal_error message: type: string example: Invalid request parameters. details: type: object properties: target: example: settings.id type: string recoveryHint: example: >- Stop the active session before reusing these settings. type: string activeSessionId: example: 58e531ee-16ca-49d0-8722-b425d154cc10 type: string format: uuid pattern: >- ^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$ nextOperationId: example: stopBrowserSession type: string requestId: example: a1901a29e82a999f-CDG type: string upstreamStatus: example: 503 type: integer minimum: 100 maximum: 599 failureStage: example: provider_browser_start type: string diagnosticCode: example: token_sign_failed type: string additionalProperties: {} required: - code - message - details required: - error example: error: code: upstream_error message: Failed to fetch data from an upstream service. details: upstreamStatus: 503 components: securitySchemes: apiKeyHeader: type: apiKey in: header name: X-Api-Key description: Client API key for the authenticated account. ````