← All guides

A free SwaggerHub Auto Mocking alternative — stateful, and no 10 req/min cap

Let's be clear first: SwaggerHub — recently rebranded Swagger Studio by SmartBear — is the canonical place to design an OpenAPI spec. The editor, the rendered docs, the code generators, the org-wide style validation: genuinely excellent, and if your team lives design-first there, keep living there.

This page is about the moment you point actual software at its built-in mock. SwaggerHub's API Auto Mocking hosts your spec at virtserver.swaggerhub.com/<owner>/<api>/<version>, and per SmartBear's own docs (September 2026) it is:

• Rate-limited to 10 requests per minute per API version. Request #11 gets a 429 Too Many Requests. A Playwright suite, a React app in dev with a few components fetching, or one npm test run trips this in seconds. The documented fix is buying On-Premise.
• Semi-static, with no state. It returns the first example from your spec, for everyone, every time. POST /users answers with the example — but creates nothing. You can't test create→read→update→delete, pagination over real rows, or "what does the empty list look like".
• No business logic — SmartBear's docs say this plainly: it cannot vary responses based on input.

And on the free personal plan, your API definition is public — visible to anyone and indexed in the public catalog. Private APIs require a paid Organization plan.

Here's how to keep designing in SwaggerHub and get a mock that behaves like a backend — free, no signup.

The one-liner migration

SwaggerHub serves every public spec raw through its registry API, so you can pipe it straight into Mockbird's importer without downloading anything:

curl -sL https://api.swaggerhub.com/apis/OWNER/API_NAME/VERSION \
  | curl -X POST https://mockbird.mockbird.workers.dev/api/projects/import --data-binary @-
# → {"id":"j5wzfngdag","adminKey":"…","baseUrl":"https://mockbird.mockbird.workers.dev/m/j5wzfngdag", …}

(For a private spec, export it from the SwaggerHub editor — Export → Download API — and --data-binary @spec.yaml the file; JSON or YAML both work, Swagger 2.0 and OpenAPI 3.x both work.) We tested this with SmartBear's own Petstore spec: resources come out seeded with your schema's shapes, and enums are kept verbatim — the imported pets really answer "status": "available".

Your mock is live immediately, with data you can actually push against:

curl "https://mockbird.mockbird.workers.dev/m/YOUR_ID/products?limit=2&select=name,price"
# → [{"id":1,"name":"Business Eye Garden…","price":11.52}, {"id":2, …}]

# writes PERSIST — this is the part virtserver can't do
curl -X POST https://mockbird.mockbird.workers.dev/m/YOUR_ID/products \
  -H 'content-type: application/json' -d '{"name":"Test Widget","price":9.99}'
# → {"name":"Test Widget","price":9.99,"id":21}
curl https://mockbird.mockbird.workers.dev/m/YOUR_ID/products/21
# → {"name":"Test Widget","price":9.99,"id":21}   ← it's really there

And no per-minute limit — we fired 15 requests in about a second while writing this and got fifteen 200s. The cap is 10,000 requests per project per day, which is a day of CI, not six seconds of it.

virtserver → Mockbird translation

Try it in 10 seconds (no account)

The shared demo project exports its own OpenAPI spec — so you can watch a spec become a stateful mock with two commands and zero setup:

curl -s https://mockbird.mockbird.workers.dev/m/demo/openapi.json \
  | curl -X POST https://mockbird.mockbird.workers.dev/api/projects/import --data-binary @-

Save the returned id and adminKey, and everything above works on your copy. Failure injection needs no setup at all:

curl -i "https://mockbird.mockbird.workers.dev/m/demo/products?mock_status=503"   # → HTTP 503
curl "https://mockbird.mockbird.workers.dev/m/demo/products/1?mock_delay=2000"    # → ~2s later

Honest comparison

Written by the Mockbird maker — bias disclosed. SwaggerHub facts checked September 2026 against SmartBear's official Swagger Studio documentation (API Auto Mocking page: 10 requests/minute per API version with 429 after, semi-static responses, first example returned, "does not support business logic", higher limits only via On-Premise; Plans page: personal plans free, private APIs on paid Organization plans). Where SwaggerHub genuinely wins: it's the canonical OpenAPI design environment, its mock speaks XML/YAML and echoes spec-defined response headers, and the mock re-syncs on every spec save — ours doesn't track your spec after import. If you mainly want spec-faithful validation of requests, Prism does that well locally: see the Prism comparison. Anonymous Mockbird projects have a per-IP daily creation cap; sign up (free) to keep projects permanently.

Full API reference in the docs. More guides: mock server from an OpenAPI spec · Prism alternative · Stoplight alternative · Apiary alternative · Postman mock server alternative · testing loading & error states. Create your API →