# Get the current browser session

```{raw} html
<div class="mo-api-page-show-toc" aria-hidden="true"></div>
```

`GET /auth/me` reads the product browser session and returns UC subject, product principal, and CSRF value. A PAT or native Bearer cannot replace a valid product session Cookie. Authentication differs from ordinary product identity APIs.

## Request and prerequisites

Requires one nonempty product session Cookie used by the deployment. Mixing current/alternate names or duplicating session/CSRF Cookies is invalid. This does not prohibit all other business Cookies.

This GET requires no existing CSRF Cookie. Without it, the service can still derive/update the CSRF value from a valid session and write a Cookie. POST logout CSRF prerequisites do not apply to this recovery read.

## Successful response

:::::::{div} mo-api-tabs
::::::{tab-set}
:::::{tab-item} Response example

```json
{"code":"OK","data":{"uc_sub":"subject-example","uid":"product-principal-example","email":"example@example.test","display_name":"Example","csrf_token":"example-csrf-token"}}
```

:::::
:::::{tab-item} Fields

| Field | Type | Description |
| --- | --- | --- |
| code | string | OK; the current success envelope has no msg |
| data.uc_sub | string | UC subject; not interchangeable with product or IAM user IDs |
| data.uid | string | Product principal ID, not a Catalog/IAM user ID |
| data.email | string | Email saved in this product session |
| data.display_name | string | Display name saved in this product session |
| data.csrf_token | string | Server-confirmed CSRF value for this product session, used by protected writes |

Extra frontend type fields such as profile_updated_at, phone, first name, and last name are not automatically response fields for this API.

:::::
::::::
:::::::

The read validates the locally unrevoked session and asks UC to verify active status; inactive sessions are revoked locally. Upstream display profiles do not mean local email/name snapshots are completely replaced on every read.

## Errors and state interpretation

| HTTP | code | Current meaning |
| --- | --- | --- |
| 401 | unauthenticated | Missing, invalid, revoked, or upstream-inactive product session. The handler clears this deployment's session/CSRF Cookies |
| 502 | ErrServiceUnavailable | UC verification dependencies unavailable; not always an expired login |
| 500 | ErrServer | Database, mapping, or other internal error |

Ordinary browser errors use code/msg, with msg derived from HTTP status text. This page does not guarantee translation of every msg according to Content-Language. See [Environments and language](cookies-environments.md) for earlier failures such as global request-language validation.
