MeshHub Developer Portal

Everything you (or your AI builder) need to integrate the MeshHub tenant API: one HTTP API to search, book, pay, and track real-world services.

Integration guide

The canonical spec — authentication, conventions, the async task model, every endpoint, webhooks, and a quick start.

Tenant integration guide (markdown)

Live API schema

OpenAPI 3 contract generated from the running API — always in sync. Load it directly into codegen and AI tools.

API playground

Drive the full flow — search, book, pay, track, cancel — from your browser with the API key issued for your tenant. Every request and response is shown in an inspector you can copy into your integration.

Open the playground

SDKs

The official TypeScript SDK wraps every endpoint with typed requests and responses, task polling, webhook signature verification, and unified error handling.

@meshhub/sdk on npm
SDK README (markdown)

Starter kit

The fastest paths from zero to a working shop.

Thin-frontend reference example — a complete minimal shop (browser → your backend → MeshHub; the API key stays server-side)
Postman collection — ready to import: mint key → search → book → pay → orders
AI-builder prompt — paste into Replit Agent (or similar) to generate a working shop with safe key handling

For AI builders

AI-ingestible indexes of this documentation, following the llms.txt convention.

llms.txt — index with links
llms-full.txt — full docs in one file

Quick start

Mint a free 7-day trial key and run a first search — no signup:

# 1. Get a key (once — reuse it; minting is capped at 3/hour per IP)
curl -s -X POST https://merchant.meshhub.ai/api/v1/auth/trial-keys/
# → 201 {"key": "mh_...", "expires_at": ..., "scopes": [...]}

# 2. Search (async: 202 + task_id)
curl -s -X POST https://merchant.meshhub.ai/api/v1/search/ \
  -H "X-MH-Key: $MESHHUB_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
        "category": "shipping",
        "currency": "EUR",
        "extra": {"origin": "LT", "destination": "DE", "weight_kg": 1}
      }'

# 3. Poll — immediately, then back off
curl -s https://merchant.meshhub.ai/api/v1/tasks/$TASK_ID/ \
  -H "X-MH-Key: $MESHHUB_API_KEY"
# when "status" is "completed", the offers are in result.offers

The integration guide (§12) continues from here through book, pay, and order history.