lanyard

github.com/Phineas/lanyard APIs & Databases Open-source projectOpen source

Expose Discord presence and activity through REST and WebSocket APIs with Lanyard.

github.com/Phineas/lanyard
lanyard homepage screenshot

About lanyard

Lanyard is an open-source service that exposes a Discord user's live presence and activities through a REST endpoint (api.lanyard.rest/v1/users/:user_id) and a WebSocket, so presence data can be displayed or consumed elsewhere. It also acts as a globally accessible realtime key-value store that can be updated from the Lanyard Discord bot or from the API. Users can rely on the hosted service by joining the Lanyard Discord server, or self-host it, which requires some configuration and is documented for Docker.

Responses include presence fields such as whether the user is active on desktop or mobile, whether they are listening to Spotify, a custom Spotify object (null when not listening), and any stored key-value data. Community-maintained wrappers and integrations exist for React, Vue, Svelte, Go, Python, Deno and Dart, among others, and the repository documentation covers socket opcodes, events and error codes.

Key features

  • REST endpoint returning a Discord user's live presence data by ID
  • WebSocket API for live presence updates
  • Subscribe to one user, several users, or every user
  • Realtime globally accessible key-value store updatable from bot or API
  • Optional self-hosting, documented for Docker
  • Community wrappers for React, Vue, Svelte, Go, Python, Dart and others
Best for: Developers who want to display or react to Discord presence and activity on websites, profiles or apps.
Good for
  • Open source and available for self-hosting with Docker
  • Hosted API can be used without deploying anything yourself
  • Presence data is available over both REST and WebSocket
Watch out for
  • Using the hosted service requires joining the Lanyard Discord server
  • Self-hosting requires some configuration

lanyard at a glance

Type
Open-source project
Pricing
Not confirmed. Check the site
Open source
Yes · Source code
Language
English
Last checked
Oct 5, 2026 · Online when checked
Listed
Oct 5, 2026

lanyard alternatives

Tools and sites you could use instead, ranked by how closely they match.

All 24 alternatives

Popular in APIs & Databases

Well-known listings from the same topic.

All 93

lanyard FAQ

How do I start using Lanyard?
Join the Lanyard Discord server, and your presence will start showing up when you GET api.lanyard.rest/v1/users/:your_id.
Can I host Lanyard myself?
Yes. Self-hosting is an option, though it requires a small amount of configuration; Docker instructions are provided.
Does Lanyard do anything besides presence data?
It also works as a globally accessible realtime key-value store that can be updated from the Lanyard Discord bot or from the Lanyard API.
Is something wrong or out of date?

Tell us and an editor will check it.

Own this website?

Claim the listing and suggest updates yourself. An editor checks every claim first.

Claim this listing