API version 2026-05-01

Build with The Spirit of Mithila

Let people sign in with their Mithila account, read profile data with their permission, and get webhooks when things happen.

# Try it with a test key
curl https://developers.vaxhost.com/api/v1/me \
  -H "Authorization: Bearer mth_test_…"

{
  "data": {
    "id": "42",
    "name": "Sita Devi",
    "email_verified": true
  },
  "meta": { "livemode": false }
}

What you get

API keys with scopes

Give each integration only the access it needs. Revoke a key instantly.

Sign in with Mithila

OAuth 2.0 with PKCE and OpenID Connect, with a clear consent screen for people.

Signed webhooks

HMAC-SHA256 signatures, automatic retries with backoff and one-click redelivery.

Test mode

mth_test_ keys for development, clearly marked in every response.

Usage analytics

Requests per day, status codes and latency for every key.

Versioned and documented

Stable /v1 URLs, an OpenAPI 3.1 file and a public changelog.

Authentication

API keys, scopes, test and live mode.

OAuth 2.0 & sign in

Authorization code flow with PKCE, tokens, refresh and OpenID Connect.

Webhooks

Receive events, verify signatures, handle retries.

The API covers accounts, the product catalog, your orders, and order fulfilment for sellers. New endpoints are announced in the changelog.