---
title: "GET /v3/val/viewer"
method: GET
path: "/v3/val/viewer"
tags: ["val"]
---

# GET /v3/val/viewer

`GET /v3/val/viewer`

Look up the identity of the viewer of an app-authenticated (intranet) val, given the X-Val-Town-User header value that Fastify forwarded to the val. Authenticated with the val's own API token (bearer auth). The projectId inside the signed header must match the caller's own project.

## Headers

- `x-val-town-user` string, required

## Response `200`

Public identity of the viewer derived from a verified X-Val-Town-User header. Only safe, public profile fields are returned — no email or tier.

- object — Public identity of the viewer derived from a verified X-Val-Town-User header. Only safe, public profile fields are returned — no email or tier.
  - `id` string, uuid, required — The viewer's user id
  - `type` 'user' | 'org', nullable, required — Whether the viewer is a user or an organization
  - `username` string, nullable, required — The viewer's handle, without the @ symbol
  - `bio` string, nullable, required — The viewer's bio, if any
  - `profileImageUrl` string, uri, nullable, required — URL to the viewer's profile image, if any
  - `url` string, uri, required — The viewer's profile URL on val.town
  - `links` object, required
    - `self` string, uri, required — URL of this viewer on this API

## Other responses

- `400` — Default Response
- `401` — Default Response
- `403` — Default Response
- `404` — Default Response

---

[API](https://skmtc.net/val-town/apis/val-town-api.md) · [All operations](https://skmtc.net/val-town/apis/val-town-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/val-town/val-town-api/revisions/4d8b6d2e6db3/schema)