Modbot Docs
APIAPI referenceVRChat users

Get time in world

GET/api/vrchat-users/metrics

How long this person has been seen in world, where, and how often. Computed from the companion's presence reports, so it only covers time a moderator's client was in the same instance. Somebody who has never shared an instance with the client reads as nothing here, which is not the same as never having been in one — and the screen says so.

Gated on ViewProfile rather than ViewAnalytics: this is one person's own record rather than an aggregate, and it sits beside the rest of their profile.

Needs the ViewProfile permission.

AuthorizationBearer <token>

An API key, made on Settings, API keys. Every key starts with mbk_.

In: header

Query Parameters

vrchatUserId*string

Also accepted as id.

Response Body

application/json

application/problem+json

application/problem+json

application/problem+json

curl -X GET "https://example.com/api/vrchat-users/metrics?vrchatUserId=string"
{  "userId": "string",  "known": true,  "counts": {    "minutesSeen": 0.1,    "worlds": 0,    "instances": 0,    "arrivals": 0,    "firstSeenAt": null,    "lastSeenAt": null  },  "recentInstances": [    {      "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",      "location": "string",      "worldId": "string",      "worldName": null,      "worldThumbnailImageUrl": null,      "vrChatInstanceId": null,      "instanceName": null,      "groupAccessType": null,      "region": null,      "openedAt": "2019-08-24T14:15:22Z",      "closedAt": null,      "closedBy": null,      "peopleNow": null,      "peakPeople": null,      "minutesOpen": 0.1,      "worldCapacity": null,      "worldPlatforms": null,      "closedByModerator": false,      "peopleNowUnsure": false,      "peakPeopleUnsure": false    }  ],  "now": "2019-08-24T14:15:22Z"}

Modbot is not endorsed by or affiliated with VRChat Inc. or Discord Inc. VRChat is a trademark of VRChat Inc. Discord is a trademark of Discord Inc. SteamVR is a trademark of Valve Corporation. Windows is a trademark of Microsoft Corporation. Docker is a trademark of Docker, Inc. PostgreSQL is a trademark of the PostgreSQL Community Association of Canada. Railway is a trademark of Railway Corp. Other names are trademarks of their respective owners; see Legal. Modbot and its logo are trademarks of the Modbot project. Open source under AGPL-3.0.