Quickstart

// first solved token in three steps

1. Grab your key. 2. POST the gate, the sitekey you see on the target page, and the URL it's served from. 3. Submit the returned token to your target the same way the page's form would.

curl https://api.solvegate.io/v1/solve \
  -H "Authorization: Bearer sk_live_•••" \
  -d gate=turnstile \
  -d sitekey=0x4AAAAAAAAA_target \
  -d url=https://app.example.com

{
  "id":       "slv_8Kd2…aF9",
  "status":   "solved",
  "gate":     "turnstile",
  "token":    "0.Xa3f…X9_cleared",
  "solve_ms": 980,
  "expires_at": 1714663200,
  "mode":     "live",
  "meter":    "credits",
  "billed":   true
}

That's the whole loop. A free sandbox key (sk_test_) requires no card and returns a deterministic "mode":"sandbox" token instantly — great for wiring this up. To clear real gates, verify your email and create a live key (sk_live_) from your dashboard.

// no key yet? the live demo runs the same call against real Turnstile widgets in the browser, so you can watch the loop before you wire it