Billing & Usage

Vendor billing is separate from MLS governance rate limits. Your plan determines how many total queries are included per month, while MLS policies control how fast you can query.

Vendor plans

Subscribing

Subscribe via the vendor dashboard or API. Checkout is powered by Stripe:

POST /api/vendor/billing/checkout
Content-Type: application/json

{ "plan": "vendor_starter" }

→ { "url": "https://checkout.stripe.com/c/pay/..." }

Redirect the user to the returned URL to complete payment. After successful checkout, billing status becomes active and MLS access is unlocked.

Managing your subscription

Access the Stripe Customer Portal to update payment methods, view invoices, or cancel:

POST /api/vendor/billing/portal

→ { "url": "https://billing.stripe.com/p/session/..." }

Checking usage

Monitor your query usage via the API:

GET /api/vendor/billing/usage

→ {
    "plan": "vendor_starter",
    "included_queries": 5000,
    "used_queries": 2347,
    "overage_queries": 0,
    "billing_period_start": "2026-02-01T00:00:00Z",
    "billing_period_end": "2026-03-01T00:00:00Z"
  }

Revenue model

Your base subscription fee goes entirely to Conduit. Revenue sharing with MLSs kicks in only on overage queries — queries that exceed your plan's included monthly allowance.

Base subscription ($99/mo or $499/mo)
    └── 100% Conduit (platform fee)

Overage queries (beyond included allowance)
    │  $0.05/query (Starter) or $0.03/query (Professional)
    │
    ├── Conduit share: (100% - MLS share)
    └── MLS share:     revenue_share_pct (10-70%, default 40%)

Example: Starter plan, 7,000 queries in a month
  → 5,000 included (no per-query charge)
  → 2,000 overage × $0.05 = $100 overage revenue
  → MLS receives 40% = $40

Billing status lifecycle