API

Premium servers can generate a read-only API key from Settings → API access in the panel, to fetch their recruitment data from an external tool (dashboard, script, in-house integration).

All requests are made to https://api.recruitbot.app/public/v1/ with the header:

Authorization: Bearer rb_your_key

Available endpoints

• GET /public/v1/candidatures — lists the server's applications (optional parameters status, limit)
• GET /public/v1/candidatures/:id — detail of one application (form answers included)
• GET /public/v1/stats — total and breakdown by status

The key only grants access to the data of the server it was generated for, never write access. It can be regenerated or revoked at any time from the panel — any integration using the old key then stops working immediately. Limit: 60 requests/minute per key.

The internal API used by the panel itself (/guilds/:guildId/...) remains private, protected by session, and is not intended for external use.