---
title: "Sso Status"
method: POST
path: "/api/user/sso-status"
tags: ["user"]
---

# Sso Status

`POST /api/user/sso-status`

Check SSO user registration state.

Returns one of three states:
1. new_user: No user exists with this email
2. local_exists: User exists but registered locally (can link to SSO)
3. sso_exists: User exists and already linked to SSO

Frontend uses this to show appropriate UI:
- new_user -> "Set Master Password"
- local_exists -> "Link SSO? Enter current master password"
- sso_exists -> "Enter Master Password"

## Request body

- SSOStatusRequest — SSO status request - checks user registration state and syncs profile. Profile fields (given_name, family_name, picture) are optional. If user exists, these fields will be updated (profile sync on every login).
  - `sso_token` string, required
  - `email` string, email, required
  - `given_name` string, nullable
  - `family_name` string, nullable
  - `picture` string, nullable

## Response `200`

Successful Response

- SSOStatusResponse — SSO status response - indicates user registration state. States: - new_user: No user exists, show "Set Master Password" - local_exists: Local user exists, show "Link SSO Account? Enter your master password" - sso_exists: SSO user exists, show "Enter Master Password"
  - `status` string, required
  - `email` string, email, required
  - `given_name` string, nullable
  - `family_name` string, nullable

## Other responses

- `422` — Validation Error

## Changes

- **2025-12-25** `aa4b06f8dede` — 2 warning, 5 info
  - removed the optional property `last_name` from the response with the `200` status
  - removed the optional property `name` from the response with the `200` status
  - added the new optional request property `family_name`
  - added the new optional request property `given_name`
  - …3 more
- **2025-10-28** `849d5e8732f6` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/arbicity/apis/arbi/changes/api/user/sso-status/post.md)

---

[API](https://skmtc.dev/arbicity/apis/arbi.md) · [All operations](https://skmtc.dev/arbicity/apis/arbi/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/arbicity/arbi/revisions/1f956ac3d1c1/schema)