Yield Mesh 1.0 API Documentation

Overview

Yield Mesh exposes the Dynamic Yield Pricing research stack as a REST API. Clients request short-TTL quotes that clear supply and demand across pulse and continuous-wave laser fleets, reserve machines, track jobs, and release inventory on completion. The live Æ Hive partner console provisions offerings and monitors sales, on-call units, customers, and utilisation.

Fleet — multi-depot catalogue, summary KPIs, reserve / release
Pricing — personalised quotes with plan discounts and utilisation surge
Booking — confirm → track → complete / release loop

Authentication

Requests may include an optional x-api-key header. The public research console uses the Æ Hive proxy without requiring a browser key. Production deployments should set DYNPRIX_DEMO_API_KEY / upstream backend policy.

x-api-key: <your-api-key>
Content-Type: application/json
Accept: application/json

Same-origin proxy

Browser clients should call the Æ Hive proxy at /api/dynprix/*. The route forwards to the Dynamic Yield Pricing backend configured via DYNPRIX_BACKEND_URL.

GET  /api/dynprix/health
GET  /api/dynprix/fleet/summary
GET  /api/dynprix/fleet/machines
GET  /api/dynprix/fleet/locations
GET  /api/dynprix/bookings
POST /api/dynprix/pricing/quote
POST /api/dynprix/booking/confirm
GET  /api/dynprix/booking/{id}/track
POST /api/dynprix/booking/{id}/complete

Endpoints

Method	Path	Purpose
`GET`	`/health`	Service heartbeat and fleet summary snapshot
`GET`	`/fleet/summary`	Available / reserved / in-use counts and utilisation
`GET`	`/fleet/machines`	Catalogue with status, rate, and depot
`POST`	`/pricing/quote`	Short-TTL personalised rental quote
`POST`	`/booking/confirm`	Confirm quote → create booking
`POST`	`/booking/{id}/complete`	Complete job and return machines to available

GET /fleet/*

Fleet endpoints return depot locations, machine catalogue (pulse and CW classes), and aggregate utilisation. Optional ?status= filters machines to available, reserved, or in_use.

{
  "total": 15,
  "available": 12,
  "reserved": 1,
  "in_use": 2,
  "utilization": 0.2
}

POST /pricing/quote

Builds a personalised quote from machine IDs, site (country / city / pin), start time, and duration. Responses include local currency conversion, plan discount, utilisation surge notes, and a short TTL to prevent hold-and-wait arbitrage.

{
  "machine_ids": ["LME-CPT-02"],
  "country": "IE",
  "city": "Dublin",
  "pin_eircode": "D02",
  "start_time": "2026-08-12T09:00:00Z",
  "duration_hours": 8
}

Booking loop

After accepting a quote, clients call /booking/confirm, optionally /booking/{id}/track for ETA, then /booking/{id}/complete to release inventory. Completing a booking returns machines to available for the next yield-clearing cycle.

Plans & surge

Partner offerings may use Basic, Pro, or Enterprise plans. Pricing logic applies subscription floors, transaction take-rates, and utilisation surge so peak scarcity raises rates while idle slots stimulate demand — the operational bridge to the Dynamic Yield Pricing research report.

Dynamic yield pricing fundamentals