---
title: "Get account settings"
method: POST
path: "/v1/account.getSettings"
tags: ["account"]
---

# Get account settings

`POST /v1/account.getSettings`

## Response `200`

OK

- V1AccountGetSettingsBody
  - `$schema` string, uri — A URL to the JSON Schema for this object.
  - `analytics` DeveloperAppAnalytics
    - `last24Hours` DeveloperAppAnalyticsLast24Hours, required
      - `failedRequests` integer, required — Number of failed requests (non-VALID outcomes)
      - `outcomeBreakdown` DeveloperAppAnalyticsOutcome[], nullable, required — Breakdown of requests by outcome
        - `count` integer, required — The number of verifications with this outcome
        - `outcome` 'VALID' | 'RATE_LIMITED' | 'INVALID' | 'EXPIRED' | 'DISABLED' | 'INSUFFICIENT_PERMISSIONS' | 'FORBIDDEN' | 'USAGE_EXCEEDED', required — The outcome of the verification
      - `successRate` number, double, required — Success rate as a percentage
      - `successfulRequests` integer, required — Number of successful requests (VALID outcome)
      - `totalRequests` integer, required — Total number of requests in the last 24 hours
    - `timeSeries` DeveloperAppAnalyticsTimeSeries, required
      - `hourly` DeveloperAppAnalyticsTimeSeriesPoint[], nullable, required — Hourly time series data for the last 24 hours
        - `count` integer, required — The number of verifications at this time
        - `outcome` string, required — The outcome of the verifications
        - `time` string, date-time, required — The timestamp of the data point
  - `chosenRole` ChosenRole, nullable, required
    - `role` 'user' | 'donator' | 'staff' | 'developer' | 'partner' | 'owner' | 'amethyst' | 'amber' | 'emerald' | 'sapphire' | 'ruby' | 'diamond' | 'contributor' | 'early_supporter' | 'beta' | 'translator' | 'top_100' | 'badge_scout' | 'nitro_booster' | 'astral' | 'nebula', required
    - `tier` string, required — The tier of the donation
  - `connections` Connection[], nullable, required — The connections the account has
    - `avatar` string, required — The avatar of the connected account
    - `connectionId` string, required — The public id of the connection
    - `externalId` string, required — The external id of the connected account
    - `failed` boolean, required — Whether the connection has failed to refresh or not
    - `hide` boolean, required — Whether the connection should be hidden or not
    - `name` string, required — The name of the connected account
    - `provider` 'discord' | 'patreon' | 'kick' | 'reddit' | 'twitch' | 'youtube' | 'x' | 'domain', required — The provider to connect with
    - `verified` boolean, required — Whether the connection has been verified or not
  - `countryOverrideCode` string, nullable — The code of the override country
  - `countryOverrideName` string, nullable — The name of the override country
  - `developerApps` DeveloperApp[], nullable, required — The developer apps the account has
    - `analytics` DeveloperAppAnalytics
      - `last24Hours` DeveloperAppAnalyticsLast24Hours, required
        - `failedRequests` integer, required — Number of failed requests (non-VALID outcomes)
        - `outcomeBreakdown` DeveloperAppAnalyticsOutcome[], nullable, required — Breakdown of requests by outcome
          - `count` integer, required — The number of verifications with this outcome
          - `outcome` 'VALID' | 'RATE_LIMITED' | 'INVALID' | 'EXPIRED' | 'DISABLED' | 'INSUFFICIENT_PERMISSIONS' | 'FORBIDDEN' | 'USAGE_EXCEEDED', required — The outcome of the verification
        - `successRate` number, double, required — Success rate as a percentage
        - `successfulRequests` integer, required — Number of successful requests (VALID outcome)
        - `totalRequests` integer, required — Total number of requests in the last 24 hours
      - `timeSeries` DeveloperAppAnalyticsTimeSeries, required
        - `hourly` DeveloperAppAnalyticsTimeSeriesPoint[], nullable, required — Hourly time series data for the last 24 hours
          - `count` integer, required — The number of verifications at this time
          - `outcome` string, required — The outcome of the verifications
          - `time` string, date-time, required — The timestamp of the data point
    - `apiKey` string, nullable, required — The api key (deprecated, always null for security)
    - `createdAt` string, date-time, required — When the app was created
    - `description` string, required — The description of the developer app
    - `environment` 'production' | 'development' | 'staging', required — The environment of the developer app
    - `id` string, required — The id of the developer app (same as keyId for backwards compatibility)
    - `keyId` string, required — The Unkey key ID
    - `name` string, required — The name of the developer app
  - `email` string, email, required — The email the account is using
  - `emailVerifiedAt` string, date-time, nullable, required — The time the email was verified
  - `hidden` boolean, required — Whether the account is hidden in the leaderboards
  - `language` string, required — The language the account is using
  - `nameEffect` 'none' | 'rainbow' | 'glitch' | 'shadow' | 'neon' | 'retro' | 'stamped' | 'shatter' | 'typewriter' | 'vaporwave' | 'sunken', required — The stored name effect
  - `privacy` 'public' | 'private' | 'friends_only', required — The privacy of the account
  - `sessions` Session[], nullable, required — The sessions the account has
    - `createdAt` string, date-time, required — The time the session was created
    - `expiresAt` string, date-time, required — The time the session expires
    - `ip` string, required — The ip of the session
    - `lastSeen` string, date-time, required — The time the session was last seen
    - `sessionId` string, required — The session id
    - `userAgent` string, required — The user agent of the session
  - `subscribed` boolean, required — Whether the account is subscribed to marketing emails
  - `themeColor` string, nullable, required — The stored profile theme color as #RRGGBB, null when unset
  - `vanity` string, required — The vanity the account is using
  - `vanityAnalytics` V1VanityAnalytics, nullable, required
    - `clicks` integer, required — The number of clicks the vanity has received

## Other responses

- `400` — Bad Request
- `401` — Unauthorized
- `404` — Not Found
- `500` — Internal Server Error

---

[API](https://skmtc.net/steamsets/apis/steamsets-api.md) · [All operations](https://skmtc.net/steamsets/apis/steamsets-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/steamsets/steamsets-api/versions/f7c45c9ec36a/schema)