swagger: '2.0' info: title: "Matrix Client-Server Administration API" version: "1.0.0" host: localhost:8008 schemes: - https - http basePath: /_matrix/client/%CLIENT_MAJOR_VERSION% consumes: - application/json produces: - application/json securityDefinitions: accessToken: type: apiKey description: The user_id or application service access_token name: access_token in: query paths: "/admin/whois/{userId}": get: summary: Gets information about a particular user. description: |- Gets information about a particular user. This API may be restricted to only be called by the user being looked up, or by a server admin. Server-local administrator privileges are not specified in this document. security: - accessToken: [] parameters: - in: path type: string name: userId description: The user to look up. required: true x-example: "@peter:rabbit.rocks" responses: 200: description: The lookup was successful. examples: application/json: |- { "user_id": "@peter:rabbit.rocks", "devices": { "teapot": { "sessions": [ { "connections": [ { "ip": "127.0.0.1", "last_seen": 1411996332123, "user_agent": "curl/7.31.0-DEV" }, { "ip": "10.0.0.2", "last_seen": 1411996332123, "user_agent": "Mozilla/5.0 (X11; Linux x86_64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/37.0.2062.120 Safari/537.36" } ] } ] } } } schema: type: object properties: user_id: type: string description: The Matrix user ID of the user. devices: type: object description: |- Each key is an identitfier for one of the user's devices. additionalProperties: type: object title: DeviceInfo properties: sessions: type: array description: A user's sessions (i.e. what they did with an access token from one login). items: type: object title: SessionInfo properties: connections: type: array description: Information particular connections in the session. items: type: object title: ConnectionInfo properties: ip: type: string description: Most recently seen IP address of the session. last_seen: type: number description: Unix timestamp that the session was last active. user_agent: type: string description: User agent string last seen in the session. tags: - Server administration