Skip to content

DevelopersLookup

Look up anything

A Minecraft address, a Discord invite or a bot's application ID (or invite link), checked live whether it's listed or not. Anything real that isn't on Lobbydex yet is added as we see it, so it's in the directory from then on.

GET/api/v1/lookup
Bucket lookup30/min with a key · 5 withoutCached 1 minKey optional

Query parameters

qrequiredstring
play.example.net, play.example.net:25566, discord.gg/code or a bot's application ID.

Response

200 OK, JSON. Full schema in openapi.json.

kindenumWhat the query was read as.
statusenumlisted: already on Lobbydex. added: listed just now by this lookup. not_added: real, but can't be listed (see note).
notestring | nullWhy it wasn't added, when it wasn't.
slugstring | null
urlstring | nullIts Lobbydex page, when listed.
liveobjectWhat we saw just now.10 fields
namestring | null
descriptionstring | null
iconstring | null
addressstring | nullMinecraft: the address checked.
javaobject | null5 fields
onlineboolean
latencyMsnumber | null
versionstring | null
playersobject | null
motdstring | null
bedrockobject | null5 fields
onlineboolean
latencyMsnumber | null
versionstring | null
playersobject | null
motdstring | null
membersnumber | nullDiscord servers: members.
membersOnlinenumber | nullDiscord servers: members online.
publicboolean | nullBots: anyone can add it.
tagsstring[]
checkedAtstring

Errors

invalid_request400

A query or path parameter is missing or out of range.

invalid_key401

The key is malformed, revoked or unknown. Leave it out to use the anonymous allowance.

rate_limited429

Over a bucket or the global limit. Wait retry_after seconds.

internal_error500

Something broke on our side. Retry with backoff.