Get the signed-in user

GET

/v1/me

const url = 'https://app.mondochat.io/v1/me';
const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};

try {
  const response = await fetch(url, options);
  const data = await response.json();
  console.log(data);
} catch (error) {
  console.error(error);
}

curl --request GET \
  --url https://app.mondochat.io/v1/me \
  --header 'Authorization: Bearer <token>'

Returns the caller’s profile with their language, onboarding and prompt flags, and their privacy choices. Needs a session token.

Guide: Users.

Authorizations

session

Responses

200

Successful Response

application/json

The signed-in user: their profile and their own privacy and onboarding state.

object

app_prompt_done

App Prompt Done

True once the user dismissed Get the app or has had a device.

boolean

avatar

Any of:

string
null

string

avatar_review

Any of:

string
null

string

Allowed values: pending rejected

external_id

required

External Id

The user’s id on your site, the sub claim.

string

required

The user’s id in mondochat.

string format: uuid

inbound

Inbound

Members: guests may not message this user.

string

default: everyone

Allowed values: everyone members

kind

required

Kind

member for a user your server signed in, guest for an anonymous one.

string

Allowed values: member guest

lang

Any of:

string
null

string

last_seen

required

Last Seen

Nobody hides this user’s last seen from everyone and everyone’s from them.

string

Allowed values: everyone nobody

name

required

Name

Display name.

string

notify_prompt_done

required

Notify Prompt Done

True once the viewer tapped or dismissed the notify prompt.

boolean

onboarding_done

required

Onboarding Done

False while the onboarding slides are due, and again onboarding.repeat_hours after they were shown when that is set.

boolean

onboarding_shown_at

Any of:

string
null

string format: date-time

read_receipts

required

Read Receipts

False: this user neither sends nor sees read ticks in any conversation.

boolean

role

required

Role

A role key from the app’s roles.

string

Example

{
  "app_prompt_done": false,
  "avatar": "https://example.test/alice.jpg",
  "external_id": "alice",
  "id": "0199d6a0-1000-7000-8000-000000000001",
  "inbound": "everyone",
  "kind": "member",
  "lang": "en",
  "last_seen": "everyone",
  "name": "Alice",
  "notify_prompt_done": false,
  "onboarding_done": true,
  "onboarding_shown_at": "2026-11-01T09:00:00Z",
  "read_receipts": true,
  "role": "member"
}

4XX

Problem

application/problem+json

An RFC 9457 problem: the body of every error answer.

object

code

required

The stable error code to branch on, such as policy_denied.

string

detail

What went wrong this time, when there is more to say.

string | null

errors

For validation, one entry per invalid field.

Array<object>

One invalid field.

object

loc

The path to the field.

array

msg

What is wrong with it.

string

instance

The path of the request.

string

reason

For policy_denied and limit_reached, the rule or limit that refused the request; for forbidden, a short cause such as you_blocked; for banned, temporary when the ban expires.

string

status

required

The HTTP status code.

integer

title

required

A short summary of the problem.

string

type

required

A URL that names the problem, https://app.mondochat.io/problems/<code>.

string

Example

{
  "code": "policy_denied",
  "detail": null,
  "instance": "/v1/conversations/0199d6a0-2000-7000-8000-000000000001",
  "reason": "pins",
  "status": 403,
  "title": "Policy denied",
  "type": "https://app.mondochat.io/problems/policy_denied"
}