Documentation/API Reference

Documentation

API Reference

Integrate SovereignMesh with your ERP, procurement system, or internal tooling. The REST API is available to all paid plans.

Base URLhttps://api.sovereignmesh.com.au

Authentication

All API requests are authenticated with a Bearer token issued from your organisation's settings page. Tokens are scoped per organisation and can be rotated at any time.

curl https://api.sovereignmesh.com.au/v1/projects \
  -H "Authorization: Bearer <your_token>" \
  -H "Accept: application/json"

Webhooks

Receive real-time notifications when project statuses change, bids are received, or vendor certifications are updated. Payloads are signed with HMAC-SHA256.

{
  "event": "project.bid_received",
  "timestamp": "2026-05-19T10:30:00Z",
  "data": {
    "project_id": "proj_abc123",
    "bid_id": "bid_xyz789",
    "vendor_id": "vnd_def456"
  }
}

Endpoints

GET/v1/projects

List marketplace projects with optional filters (status, category, search).

GET/v1/projects/:id

Retrieve a single project with full details, requirements, and bid summary.

POST/v1/projects

Create a new procurement project (buyer accounts only).

GET/v1/vendors

Search verified vendor profiles by capability, certification, or location.

GET/v1/vendors/:id

Get a vendor's full profile including certifications and verification status.

POST/v1/bids

Submit a bid against an open project (verified vendor accounts only).

GET/v1/webhooks

List configured webhook endpoints for your organisation.

POST/v1/webhooks

Register a new webhook for project, bid, or verification events.

Full OpenAPI specification available

Download the OpenAPI 3.1 spec or explore with your API client.

Request access