Skip to navigation

Get a server's bump status and history

View as Markdown

Returns whether the server can be bumped right now, when the cooldown ends, and the current bump streak, plus a paginated history of bumps, newest first. The API key must belong to the server’s owner. History only covers bumps made since bump tracking launched; earlier bumps appear only in lastBumpedAt.

Authentication

AuthorizationBearer

A FluxerList API key. Keys start with fl_.

Path parameters

idstringRequired
The server's Fluxer guild ID.

Query parameters

pageintegerOptional>=1Defaults to 1
Page number, starting at 1.
limitintegerOptional1-100Defaults to 50
Results per page. Values above 100 are capped at 100.

Response

Bump status and a page of bump history.
lastBumpedAtdatetime or nullOptional
When the server was last bumped, or null if it never has been.
canBumpbooleanOptional
Whether the cooldown has ended and the server can be bumped now.
nextBumpAtdatetime or nullOptional

When the cooldown ends. Null when canBump is true.

cooldownHoursintegerOptional
The owner's current bump cooldown, 6 with an active bump boost and 12 otherwise.
bumpStreakintegerOptional
Consecutive UTC days with at least one bump.
totalintegerOptional
Total recorded bumps across all pages.
pageintegerOptional
limitintegerOptional
bumpslist of objectsOptional

Errors

401
Unauthorized Error
403
Forbidden Error
404
Not Found Error
429
Too Many Requests Error