Evaluation Summary
Full scoring results for all evaluated bidders
Loading…
API Reference
deVeres Auction — Bidder Evaluation API v2.0
GET
/health
Service health & stats
{ "status": "ok", "version": "2.0.0", "port": 8003,
"results_cached": 5, "decision_overrides": 1,
"emails_queued": 2, "timestamp": "2026-05-11T20:00:00Z" }
POST
/evaluate
Run full bidder scoring pipeline
Request: { "dry_run": true, "use_odoo": false }
Response: { "total": 5, "approved": 3, "reviewed": 0, "rejected": 2,
"reports_written": 5, "emails_drafted": 3, "results": [...] }
GET
/results
List all evaluated bidders
[{ "bidder_id": "BDR-001", "bidder_name": "Margaret O'Sullivan",
"score": 0.7133, "recommendation": "approve",
"manual_decision": null, "total_bids": 8, "matched_lots": 3 }, ...]
GET
/results/{bidder_id}
Full detail for one bidder
{ "bidder_id": "BDR-004", "score": 0.7633,
"breakdown": { "win_loss_rate": 1.0, "bid_count": 0.567, ... },
"matched_lots": [...], "rejection_reasons": [] }
POST
/decision/{bidder_id}
Manual accept / reject override (admin only)
Request: { "decision": "approve" } // or "reject" | "review"
Response: { "ok": true, "bidder_id": "BDR-004", "decision": "approve" }
DELETE
/decision/{bidder_id}
Revert to algorithmic recommendation
Response: { "ok": true, "bidder_id": "BDR-004" }
GET
/emails/{bidder_id}
Drafted outreach email for one bidder
{ "subject": "Preview Invitation — Upcoming Auction Lots...",
"body": "Dear Patrick, ...", "status": "dry_run" }
POST
/compose-email
Log and optionally schedule an outreach email
Request: { "to": "bidder@example.ie", "cc": "", "subject": "...",
"body": "...", "schedule_at": "2026-05-15T10:00:00" }
Response: { "ok": true, "email_id": "mail_0001", "status": "sent" }
GET
/pending-emails
List all composed / scheduled emails
[{ "id": "mail_0001", "to": "...", "subject": "...",
"status": "sent", "sent_at": "2026-05-11T21:00:00Z" }, ...]
GET
/summary
Markdown summary table of all results
# deVeres Auction — Bidder Evaluation Summary | # | Bidder | Score | Recommendation | Bids | Wins | Trajectory | |---|--------|-------|----------------|------|------|------------| | 1 | Patrick Doyle | 0.76 | ✅ Approve | ... |
GET
/reports/{bidder_id}
Detailed Markdown report for one bidder
Returns full Markdown report with score bar, dimension table, matched lots, and recommendations. Plain text response.
Loading…