Savee Developers
APIReference

User

GET
/v1/me

Get the authenticated user

Authorization

Authorization
Required
Bearer <token>

Personal access token (sv_live_…) — represents you and carries every scope, so no scope is required for this call. Best for your own scripts and internal tools. Generate one at https://savee.com/developers/.

In: header

Authorization
Required
Bearer <token>

OAuth access token (sv_at_…) — obtained on one of your users’ behalf and limited to the scopes they approved. Use this when you’re building a product other people sign into with Savee. See https://docs.savee.com/api/oauth.

Missing the scope below returns 403 with a WWW-Authenticate: Bearer error="insufficient_scope" header naming it.

In: header

Scope: profile:read

Status codeDescription
200Authenticated user.
400Invalid input.
401Missing or invalid Bearer token.
402Authenticated but the user has no active subscription.
403The Public API is not available on this account.
429Rate limit exceeded. Retry after the number of seconds in Retry-After.
500Unexpected server error.
curl -X GET "https://api.savee.com/v1/me"

{
  "id": "63e1a4c2d242ec00094007f1",
  "username": "aliceb",
  "name": "Alice Bauer",
  "url": "https://savee.com/aliceb/",
  "avatar_url": "https://dm.savee.com/user-avatar/original/8kQ2mZp.jpg",
  "plan": {
    "active": true,
    "tiers": [
      "pro"
    ]
  }
}

Previous

System

Next

Saves

On this page