---
title: "Get the authenticated account"
method: GET
path: "/v1/me"
tags: ["Account"]
---

# Get the authenticated account

`GET /v1/me`

## Request

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

Account summary plus the earn-side rollup (credits earned today / last 7 days), active FeelingSurfViewer session count, and site-slot usage.

## Response `200`

Account summary.

- AccountSummary
  - `id` integer: Unique identifier.
  - `username` string: Your username.
  - `plan` 'free' | 'premium': Membership plan.
  - `credits` number, float: Current credit balance.
  - `earning` object: Credits earned by surfing.
    - `credits_today` number, float: Credits earned by surfing today.
    - `credits_last_7_days` number, float: Rolling sum over the last 7 days (today inclusive).
  - `surfing` object: Your live surfing activity.
    - `active_sessions` integer: FeelingSurfViewer sessions active in the last few minutes.
  - `site_slots` object: Site-slot usage; create returns 403 once `used` reaches `max`.
    - `used` integer: Site slots currently in use (your number of sites).
    - `max` integer: Total site slots your plan allows.
    - `available` integer: Unused site slots (max minus used).
  - `visit_own_sites` boolean: Whether the app also surfs your own sites.
  - `timezone` string, nullable: IANA timezone for active-hours scheduling; UTC is used when null.
  - `currency` 'eur' | 'usd': Your billing currency.
  - `language` 'en' | 'fr' | 'es' | 'pt' | 'ru' | 'vi' | 'id' | 'tr' | 'de' | 'it' | 'nl': Your account language (ISO code).
  - `newsletter` boolean: Newsletter email opt-in.
  - `invoice_emails` boolean: Whether invoice emails are sent.
  - `subscription` object: Premium subscription lifecycle.
    - `active` boolean: Whether an active premium subscription exists.
    - `renews_at` string, date-time, nullable: Next renewal date while active and not cancelled.
    - `ends_at` string, date-time, nullable: When premium access ends after a cancellation.

## 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)