Yield Mesh 1.0 Pricing API

Yield Mesh 1.0 exposes a Redis-ready, real-time pricing API for equipment rental yield management. Quotes are signed with a short TTL; fleet state (available / reserved / in-use) stays consistent for partners and customers. Converted from DYNPRIX static/arkham/api-doc.html.

Overview

Use this service when you need demand-responsive rental rates, multi-machine quotes, location-aware delivery, and auditable booking tracking — aligned with the Dynamic Yield Pricing program process (quote → clearing price → lease → billing).

15-unit demo fleet with dedicated IDs (EQ-001 … EQ-015)
Multi-select machines, sites, and timing
Live status board for customers and vendor partners
Same-origin proxy at /api/yieldmesh

Concepts

Concept	Description
Quote	Time-limited price offer (≈90–120s). Selected machines become reserved.
Booking	Confirmed reservation. Machines move to in_use.
Utilization	Share of fleet reserved or in use; drives surge pricing.
Location	Delivery / job site destination for tracking.

Authentication

Demo deployment accepts calls through the Data-T proxy with optional x-api-key. Partner apps should send Authorization: Bearer <token> when API keys are enabled in production.

Get a price quote

POST /pricing/quote via /api/yieldmesh/pricing/quote

curl -X POST https://www.data-t.uk/api/yieldmesh/pricing/quote \
  -H 'Content-Type: application/json' \
  -d '{
    "machine_ids": ["EQ-001", "EQ-006"],
    "location_id": "LOC-NYC-01",
    "start_time": "2026-08-10T14:00:00Z",
    "duration_hours": 8
  }'

Confirm a booking

POST /booking/confirm

curl -X POST https://www.data-t.uk/api/yieldmesh/booking/confirm \
  -H 'Content-Type: application/json' \
  -d '{ "quote_id": "<uuid>", "customer_name": "Site Foreman" }'

Track delivery

GET /booking/{booking_id}/track returns status, coordinates, and ETA. Complete with POST /booking/{booking_id}/complete to return machines to available.

Fleet & availability

GET /fleet/machines — catalog + status
GET /fleet/locations — delivery sites
GET /fleet/summary — counts / utilization
GET /bookings — partner booking list

API endpoints

Method	Path	Purpose
GET	`/health`	Liveness + fleet summary
GET	`/fleet/machines`	List equipment
GET	`/fleet/locations`	List sites
GET	`/fleet/summary`	Utilization
POST	`/pricing/quote`	Multi-machine quote
POST	`/booking/confirm`	Confirm → in_use
GET	`/booking/{id}/track`	Tracking
POST	`/booking/{id}/complete`	Release fleet
GET	`/bookings`	Partner ledger

Errors

Code	When
400	Invalid location or empty machine list
409	Machine not available / already reserved
404	Quote or booking not found
410	Quote expired

Program & business process

Client-facing process maps from the research media set:

Program flow — Search → Quote → Pricing engine (RL / auction / SDP) → Market-clearing price → Lease → Billing ledger
Business flow — Customer segments ↔ Platform ↔ Strategic partners ↔ Revenue streams ↔ Infrastructure costs

Program process diagram — Program process

Business process diagram — Business process

Open Yield Mesh 1.0 console Download research paper