GET /v1/me — val-town-api

Get profile information for the current user

get/v1/me

Response

Your user information, with tier and email included

idstring uuid required

The ID of this user

type'user' | 'org' required

Whether this is a user or an organization

biostring nullable required

The user’s biography, if they have provided one

usernamestring nullable required

The user’s handle that they chose for themselves. Does not include the @ symbol

profileImageUrlstring uri nullable required

URL that points to the user’s profile image, if one exists

urlstring uri required

URL of this user’s profile on Val Town’s website

tier'free' | 'pro' | 'business' nullable required

Your account tier

emailstring nullable required

Your email address

Example response

{
  "id": "00000000-0000-0000-0000-000000000000",
  "bio": "Hello world",
  "username": "tmcw",
  "url": "https://val.town/u/tmcw",
  "profileImageUrl": null
}

Changes

Changed in 3 of the 46 revisions of this API.1312

Mar 18, 20267ca4c991c6cc21See the full diff
- ▲
  the allOf[User]/type response's property type/format changed from string/ to / for status 200
  response-property-type-changed
- ▲
  the allOf[subschema #2]/tier/anyOf[subschema #1]/ response's property type/format changed from string/ to / for status 200
  response-property-type-changed
- ●
  added the new business enum value to the allOf[subschema #2]/tier/anyOf[subschema #1]/ response property for the response status 200
  response-property-enum-value-added
Mar 11, 2026dc1b3c9e3b2a101See the full diff
- ▲
  the response's body type/format changed from object/ to / for status 200
  response-body-type-changed
- ▲
  removed the required property bio from the response with the 200 status
  response-required-property-removed
- ▲
  removed the required property email from the response with the 200 status
  response-required-property-removed
- ▲
  removed the required property id from the response with the 200 status
  response-required-property-removed
- ▲
  removed the required property links from the response with the 200 status
  response-required-property-removed
- ▲
  removed the required property profileImageUrl from the response with the 200 status
  response-required-property-removed
- ▲
  removed the required property tier from the response with the 200 status
  response-required-property-removed
- ▲
  removed the required property type from the response with the 200 status
  response-required-property-removed
- ▲
  removed the required property url from the response with the 200 status
  response-required-property-removed
- ▲
  removed the required property username from the response with the 200 status
  response-required-property-removed
- ○
  added User subschema #2 to the response body allOf list for the response status 200
  response-body-all-of-added
Aug 8, 202527348c6236c811See the full diff
- ▲
  response property email list-of-types was widened by adding types null to media type application/json of response 200
  response-property-list-of-types-widened
- ○
  added the required property type to the response with the 200 status
  response-required-property-added

Full history