---
title: "List your FeelingSurfViewer sessions"
method: GET
path: "/v1/surf-sessions"
tags: ["Account"]
---

# List your FeelingSurfViewer sessions

`GET /v1/surf-sessions`

## Request

- Base URL: `https://api.feelingsurf.fr`
- URL: `https://api.feelingsurf.fr/v1/surf-sessions`
- Auth: HTTP bearer

Recent FeelingSurfViewer sessions on your account (the earning side), most recent first. These are your own FeelingSurfViewer instances and their IPs.

## Query parameters

- `limit` integer
- `offset` integer

## Response `200`

A page of surf sessions.

- object
  - `data` SurfSession[]
    - `ip_address` string: The IP address this session runs from.
    - `country_code` string, nullable: ISO country code of the IP, or null if unknown.
    - `credits_earned` number, float: Credits this session has earned.
    - `active` boolean: Whether the session was active in the last few minutes.
    - `last_activity_at` string, date-time, nullable: When the session was last active.
    - `app_version` string, nullable: FeelingSurfViewer app version, e.g. "2.5.0".
    - `app_version_outdated` boolean: Whether this app version is behind the current release.
    - `app_version_supported_until` string, date-time, nullable: When support for this app version ends, or null.
    - `low_quality_ip` boolean: The IP is classified low-quality (earns more slowly).
    - `overused_ip` boolean: True when this IP has tripped one of your account's session limits — for example too many simultaneous sessions from the same IP or IP subnet, or your account-wide session cap. While flagged, further sessions from the IP are rejected, so it earns less until it drops back under the limit.
    - `proxy_addresses` string[]: The proxies this address is the exit of, as `host:port` (IPv6 hosts bracketed), so you can tell which of your proxies the session goes through. Several when proxies share an exit, empty when the session uses your own connection.
  - `meta` PageMeta: Pagination metadata for a list response.
    - `limit` integer: Page size applied (clamped).
    - `offset` integer: Number of items skipped before this page.
    - `total` integer: Total number of items across all pages.

## Other responses

- `401`: Missing or invalid API key.
- `403`: The request is not allowed. A banned or disabled account is rejected with `forbidden`; a site setting your plan does not include is rejected with `premium_required`.
- `429`: Too many requests — the per-account, per-minute rate limit was exceeded. Wait the number of seconds given in the `Retry-After` response header, then retry.

---

[API](https://skmtc.dev/feelingsurf/apis/feelingsurf-api.md) · [All operations](https://skmtc.dev/feelingsurf/apis/feelingsurf-api/llms.txt) · [OpenAPI document](https://skmtc.dev/feelingsurf/apis/feelingsurf-api/revisions/8b09d26880d6?raw)