Marketplace API

Endpoints for opportunities and tenders.

List opportunities

GET /api/marketplace/opportunities?status=OPEN&projectType=construction

Returns OPEN + isPublic opportunities. Public list; the per-row

detail requires auth.

Post opportunity

POST /api/marketplace/opportunities

Creates an opportunity for the caller's org. Requires a session

or a token with marketplace:write scope.

Submit tender

POST /api/marketplace/opportunities/[opportunityId]/tenders

Bidding org submits a tender. Multiple tenders per org are

rejected (one bid per opportunity per org).

Award tender

POST /api/marketplace/opportunities/[opportunityId]/award

Hosting org awards a tender; this writes a MarketplaceConversionLog

row and creates the resulting project (P18.16).

Cross links

• /docs/engines/certify: how match scores factor in Certify
• /docs/api/webhooks: webhook events fired on opportunity state changes