x403 API reference
Base URL: https://www.x403-harbinger.com
| Path | Access | Role |
|---|---|---|
GET /.well-known/harbinger | public | Canonical machine document (alias /.well-known/x403.json) |
GET /v1/index | public | Listed services |
GET /v1/watches | public | Named watches with price, window, billing, deliveries |
GET /v1/agency | public | Instrument and watch catalog |
GET /v1/tape | public | Free last prints |
GET /v1/stream | 403 until grant | Notify stream (SSE or JSON) |
POST /v1/hooks | 403 until grant | Register a webhook for a watch |
POST /v1/patrol | 403 until grant | Run a live sweep |
/llms.txt | public | Agent-readable site card |
Headers
| Header | Role |
|---|---|
| X-Harbinger-Version | Protocol id x403-HARBINGER/1.0 |
| X-Harbinger-Forbidden | Challenge: grant-required |
| X-Harbinger-Grant | Signed grant (hp2.…) |
| X-Harbinger-Receipt | Settlement proof |
| X-Harbinger-Watch | Watch id |
| X-Harbinger-Event | Event name |
| X-Harbinger-Correlation | Join score 0–1 |
| X-Harbinger-Advantage-Window | Estimated lead in ms |
| X-Harbinger-Price | Quoted price |
| X-Harbinger-Delivery | Rails for this watch |
| X-Harbinger-Crawl | Crawler flag |
| X-Harbinger-Monitor / Renew / Signature | Monitor id, renewal, webhook signature |