Health, terms version, robots and sitemap
These small endpoints complete the public surface. None of them takes parameters.
Health check
Section titled “Health check”GET /healthz is the simplest possible check that the API is up. It answers the plain text ok with Content-Type: text/plain; there is no JSON.
curl -s "https://bazoodle.com/api/v1/healthz"ok- Use it from an uptime monitor when you only want a yes or no, very cheaply. Use Status when you want to know which part has a problem.
- If it fails (no answer, or anything but
200 ok), the API is not reachable from where you are. Check/statusfrom another network before you decide it is down for everyone. - It also answers at
https://api.bazoodle.com/healthz. Please do not poll faster than once every 10 seconds.
Terms version
Section titled “Terms version”GET /terms-version returns the version of Bazoodle’s Terms of Service that is in force. It is a date. Most tools never need it; it is useful if you display or link to the Terms and want to notice when they change.
curl -s "https://bazoodle.com/api/v1/terms-version"{"version": "2026-10-16"}| Field | Type | Meaning |
|---|---|---|
version |
string | The date the current Terms took effect, as YYYY-MM-DD. Compare it as text and expect other formats may be used later. |
The Terms themselves are at bazoodle.com/terms, next to the Community Rules and the Privacy Policy. Link to those pages; do not copy their text. When the version changes, players with accounts are asked to read and accept the new Terms in Bazoodle. Cached for 5 minutes.
robots.txt
Section titled “robots.txt”curl -s "https://bazoodle.com/robots.txt"It tells crawlers which paths they may visit:
- Crawlers may read the public pages and the read-only catalogue, media and status endpoints those pages need:
/api/catalog/,/api/media/and/api/status. - Crawlers are asked to stay away from the rest of the API (
/api/), the sign-in routes (/auth/), the game player (/play/), the editor (/edit/) and the staff app (/staff). - Pages with personal content, such as settings or sign-in, also say
noindexon the page itself. - The file lists the sitemap address.
If you write a crawler, follow robots.txt. The API’s own rate limits apply to everything under /api/.
sitemap.xml
Section titled “sitemap.xml”curl -s "https://bazoodle.com/sitemap.xml"The sitemap is an XML list of public pages: the home page, the information pages, these docs and the page of each public game (https://bazoodle.com/game/<id>). It is made from the catalogue, so a newly published game appears after it passes its checks, and it holds kid-friendly games only. It is a good way to learn the address of every game page without calling the API at all. If you only need the games, Browse gives you cards with more detail in fewer requests.