Brill Bidding Service

Version 0.1.0.0 · Built 2026-05-23 13:25:36 Coordinated Universal Time

API for bridge bidding and card play analysis. Interactive API docs (Swagger)

Play & analysis

EndpointDescription
/bidGet next bid
/bidsGet all possible bids with scores
/leadOpening lead recommendation
/playCard play recommendation (NN/Brill/ACE)
/autoplayAuto-play full hand
/claimDeclarer-claim end-of-board: same params as /play + tricks=extra → saves PBN with Result = (tricks declarer already won from played) + extra, returns {claim, result, board, saved}
/pbn/finalizeEnd-of-board hook (GET query or POST JSON): client sends {board, dealer, vul, ctx, played, deal?, passedout?} to save final PBN
/ddDouble-dummy analysis
/explainExplain bidding sequence
/getresponsesPossible responses to auction
/evaluateEvaluate hand in auction context (POST JSON)
/suitcSuit combination analysis (POST JSON)

Diagnostics, logs & saved data

EndpointDescription
/versionSystem version info
/readyReadiness check (startup time)
/healthHealth check
/memoryMemory usage and cache diagnostics
/logsView engine log files
/servicelogView request-timing / STUCK watchdog log — last 500 lines (download full log)
/timingsDownload per-request timing CSV (persistent across restarts)
/missingMissing auction contexts (for rule authoring)
/missing/autogeneratedDownload AutoGeneratedRules.json (feed to RuleUpdater)
/pbnSaved completed-board PBN snapshots (list + per-board download)
/pbn/all.pbnDownload all saved PBN snapshots as one multi-game file