REST API
Presence
Read a monitored user's full presence, or your own via @me.
Get presence
GET /v1/users/:user_idReturns the full presence object for a monitored user (someone who shares a server with the bot). Reads are public and unauthenticated by design.
curl https://api.zruvix.com/v1/users/94490510688792576Response (trimmed):
{
"success": true,
"data": {
"discord_user": { "id": "...", "username": "..." },
"discord_status": "online",
"active_on_discord_desktop": true,
"custom_status": { "text": "building zRuvix", "emoji": { "name": "🌱", "id": null, "animated": false } },
"listening_to_spotify": true,
"spotify": { "...": "..." },
"listening_to_youtube_music": false,
"youtube_music": null,
"now_playing": { "...": "..." },
"activities": ["..."],
"banner": "a1b2c3...",
"banner_url": "https://cdn.discordapp.com/banners/.../a1b2c3....png?size=1024",
"accent_color": 8095231,
"member_since": 1438360855000,
"kv": { "location": "Tokyo" }
}
}user_not_monitored
If the user isn't monitored you get 404 user_not_monitored.
Response fields
Prop
Type
Get @me
GET /v1/users/@meReturns your own presence, resolved from your API key.
curl https://api.zruvix.com/v1/users/@me \
-H "Authorization: <your_api_key>"