Skip to main content

Permanent user IDs

An account's id is permanent. A display name and profile slug can change, so store the user ID in integrations. Users can find it under Account settings → Account profile.

Search by name​

GET https://api.vrchatlegends.com/api/users?q=alice&limit=20&offset=0

q is required, with 2–80 characters. Matching is case-insensitive and Unicode-normalized. Names are not unique: let the person select the correct result. limit is 1–50; results include users, total, offset, and limit.

Look up an ID​

GET https://api.vrchatlegends.com/api/users/{userId}

The response contains a user object with id, displayName, avatar, and an optional profile containing its current id and path. These endpoints do not return emails, provider identifiers, password information, or session data.

Private/unlisted profile owners and banned accounts are omitted from this directory. A hidden, missing, or deleted user returns 404; do not assume an earlier public result will remain public forever.