Modbot Docs

List a person's visits

GET/api/audit/visits

Where one VRChat user has been seen, a visit per row, newest first: the arrival (or "already here" when a moderator's companion arrived after them), the leave when one was seen, until (when they left, or the last report from that instance when nobody saw them go), the display name they had, the avatars they were seen changing into, and seenBy, the moderators whose companions reported them. Visits are made from the companion's presence reports exactly as the time-in-world figures are, so they only cover time a moderator was in the same instance.

Needs ViewAuditLog, the permission that reads the same arrivals and leaves in the audit log. Paged by keyset: send the returned next back as beforeStartedAt and beforeId; both are required.

AuthorizationBearer <token>

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

In: header

Query Parameters

person?string
beforeStartedAt?string
Formatdate-time
beforeId?integer
Formatint64
limit?integer
Formatint32

Response Body

application/json

application/problem+json

application/problem+json

application/problem+json

curl -X GET "https://example.com/api/audit/visits"
{  "visits": [    {      "arrived": {        "id": 0,        "occurredAt": "2019-08-24T14:15:22Z",        "occurredBefore": null,        "observedAt": "2019-08-24T14:15:22Z",        "precision": "Exact",        "type": "string",        "typeRaw": null,        "category": "Moderation",        "source": "string",        "subjectPlatform": "string",        "subjectId": "string",        "subjectKind": "Person",        "subjectName": null,        "actorPlatform": null,        "actorId": null,        "actorName": null,        "worldId": null,        "worldName": null,        "instanceId": null,        "modbotInstanceId": null,        "instanceName": null,        "description": null,        "data": null,        "subjectTrustRank": null,        "actorTrustRank": null,        "linked": null,        "reportedBy": null,        "caseFileId": null,        "reviewId": null      },      "left": null,      "seenLeaving": true,      "until": "2019-08-24T14:15:22Z",      "name": null,      "avatars": [        "string"      ],      "seenBy": [        {          "accountId": "3d07c219-0a88-45be-9cfc-91e9d095a1e9",          "name": null,          "at": "2019-08-24T14:15:22Z"        }      ]    }  ],  "next": null,  "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.

Get how an instance compared with its world GET

How one instance compared with the other instances in its world while it was open: where it ranked by head count at each read of the world's page, the busiest of the others, and how many people were in the world. Read from Modbot's own tables; nothing here waits on VRChat. The world's page is read every two minutes while the group has an instance open in that world, so an instance that closed before those reads began has no readings. The other instances' numbers are the world page's list; this instance's is the list's when the list carries it (`listed`), and its own head count otherwise. The first time a shown instance or its group has no name Modbot has asked for, and its location does not say outsiders cannot join (invite, friends, friends+, a group's members or members and their friends), Modbot asks VRChat for it once, in the background, and keeps the answer, a refusal included. `namesComing` is true while such a read is waiting; asking again a few seconds later shows what it found. Needs the `ViewAnalytics` permission.

Get a person's milestones GET

How many dates of calendar events one VRChat user came to, the date of the event Modbot calls their first moment (`firstAt`) and of the one that made them a Regular (`regularAt`), and the visit that ended their latest gap of the welcome-back length or more. Counted from the companion's presence reports, so only people in an instance where a moderator's app was present are counted. Needs ViewAuditLog, the permission that reads the same arrivals in the audit log.