Skip to content

Interactive API Explorer

Try the WalletGate API directly in your browser. No code required!

Try it Live

Use your test API key (wg_test_*) to make real API calls directly from this page.

  1. Click the green "Authorize" button
  2. In the ApiKeyAuth field, paste your key value exactly as-is (e.g. wg_test_abc123)
  3. Ensure the server is set to https://api.walletgate.app
  4. Expand an endpoint and click "Try it out"

Before You Start (Auth Quick Guide)

To use "Try it out", provide credentials in the Authorize dialog:

  • Public API (/v1/*): ApiKeyAuth only

    • Click Authorize → under "ApiKeyAuth" paste just your key value (example: wg_test_abc123 — do not include Bearer).
    • Don’t have a key? Create an account at https://walletgate.app. A test key (100/mo) is shown once after sign‑up.
  • Admin API (/admin/*): AdminSession cookie

    • Sign in to the admin console (local or hosted). After logging in, open DevTools → Application → Cookies and copy the value of wg_admin_session.
    • Click Authorize → under "AdminSession" paste that cookie value. For mutating admin calls, use the returned csrfToken from /admin/auth/login or /admin/auth/status as header x-csrf-token when prompted.

Notes

  • The docs UI only accepts test keys (wg_test_*) for /v1/* calls.
  • Admin endpoints and production calls are disabled by default; enable them with the toggles above only when needed.

Where to find wg_admin_session (screenshot)

If you logged into the admin console in another tab, open DevTools → Application → Cookies, select the site, then copy the value of wg_admin_session.

DevTools showing wg_admin_session cookie and its value
AdminSession helper
Then paste into Authorize → AdminSession (cookie). For writes, include header x-csrf-token returned by /admin/auth/login or /admin/auth/status.
What this helper does:
  • Detect — grabs wg_admin_session from cookies (same-origin only)
  • Paste/Copy — move cookie value to/from your clipboard safely
  • Open Authorize — jumps you straight to Swagger’s auth modal
It never sends your cookie to our servers; everything runs in your browser.
For safety, docs only allow test keys (wg_test_…) and block large payloads.

Quick Start

  1. Get Your API Key: Sign up at walletgate.app
  2. Click "Authorize" above (green button)
  3. Paste Your Key in ApiKeyAuth (just wg_test_your_key_here — no Bearer prefix)
  4. Try Endpoints: Expand any endpoint and click "Try it out"

Example Request

Expand the POST /v1/verify/sessions endpoint and try this payload:

json
{
  "checks": [
    { "type": "age_over", "value": 18 },
    { "type": "residency_eu" }
  ]
}

Need Help?

Troubleshooting CORS (Try It Out)

If the in‑browser "Try it out" fails with a CORS error, verify your Origin is allowed by the API.

Run this preflight check (replace YOUR_ORIGIN with your site, e.g. https://docs.walletgate.app):

bash
curl -i -X OPTIONS \
  https://api.walletgate.app/v1/verify/sessions \
  -H "Origin: YOUR_ORIGIN" \
  -H "Access-Control-Request-Method: POST" \
  -H "Access-Control-Request-Headers: authorization,content-type"

Expected:

  • 200 OK or 204 No Content
  • An Access-Control-Allow-Origin: YOUR_ORIGIN header

If not present, add YOUR_ORIGIN to the backend CORS_ORIGINS environment variable and redeploy the API.

Developer-first EU Digital Identity verification