API REFERENCE · READ SURFACE

The wire, machine-readable.

The real endpoint surface behind The Regent Wire — documented honestly. Public reads and authenticated reads are built and staged; they enter service after the external penetration test signs off. The subscribe endpoint is live today.

Endpoint	What it returns	Auth	Status
`GET /api/feed`	The wire feed. Params: `wire` (defaults to the host you call), `desk`, `q` (full-text on headline/standfirst). Live items only, newest first.	public	STAGED — PENDING PEN-TEST
`GET /api/frontpage`	Today’s front page — issue number, date and ranked slots. Param: `wire` (defaults to the host).	public	STAGED — PENDING PEN-TEST
`GET /api/editorial/snapshot`	The editorial snapshot — desks, counts, latest issue state. Clearance L3+.	session cookie	STAGED — PENDING PEN-TEST
`GET /api/editorial/records?q=`	Records search — parameter-bound LIKE on title across the document register. Clearance L3+.	session cookie	STAGED — PENDING PEN-TEST
`POST /api/list/subscribe`	Newsletter list subscribe — the endpoint behind every form on this site.	public	LIVE

curl examples

# Public reads (staged surface — same shape on the live domain) curl -s "https://regentwire.com/api/feed?desk=coffers&q=sanctions" curl -s "https://regentwire.com/api/frontpage" # Authenticated reads — session cookie issued at sign-in (L3+ clearance) curl -s -H "Cookie: wsi_sess=<session>" "https://regentwire.com/api/editorial/snapshot" curl -s -H "Cookie: wsi_sess=<session>" "https://regentwire.com/api/editorial/records?q=treasury" # Live today curl -s -X POST "https://regentwire.com/api/list/subscribe" \ -H "Content-Type: application/json" \ -d '{"email":"you@example.com","source":"api-docs"}'

Authentication

Today, authenticated reads use the wsi_sess session cookie issued at sign-in — clearance L3+ for editorial reads. Per-account token keys (Authorization: Bearer) are issued at Console / Bureau activation and replace cookie auth for server-to-server use. Webhook delivery is configured at activation on tiers that carry it.

Rate limits

Access	Rate limit	Notes
Public (anonymous)	`60 req / min / IP`	Feed and front page reads. Cached at the edge.
Member session	`120 req / min`	Session-cookie reads, per account.
Token key (Console / Bureau)	`600 req / min`	Issued at activation, with webhook delivery where the tier carries it.

Launch policy, enforced at the edge — final numbers are confirmed on your activation sheet. Sustained scraping or redistribution is a terms violation, not a rate-limit problem.

MEMBER CADENCE — The Morning Cable daily at 06:00 GMT · The Long File every Sunday · corrections-first feed as issued · Bureau Alerts in under 60 seconds (The Bureau).