Mock Data API

Generate realistic fake / test data as clean JSON — people, companies, addresses, products and 16+ more types. Fully synthetic (built on @faker-js/faker): no real personal data, ever.

Try it

curl "https://mock.wrapper-agency.com/api/v1/mock?type=person&count=10&locale=en"

Free endpoint (live, no key during beta)

GET https://mock.wrapper-agency.com/api/v1/mock?type=person&count=10&locale=en

{
  "type": "person",
  "count": 10,
  "locale": "en",
  "seed": null,
  "data": [
    {
      "id": "9b1deb4d-3b7d-4bad-9bdd-2b0d7b3dcb6d",
      "firstName": "Jordan",
      "lastName": "Rivera",
      "fullName": "Jordan Rivera",
      "email": "jordan.rivera@example.com",
      "phone": "+1 555-0143",
      "address": { "city": "Austin", "state": "Texas", "zipCode": "78701" }
    }
  ],
  "source": "Synthetic data generated with @faker-js/faker — no real PII"
}

Free tier returns up to 100 records per call. Pass ?seed=123 for deterministic output. See the OpenAPI spec and the developer guide.

Bulk endpoint (paid, up to 10,000 / call)

POST https://mock.wrapper-agency.com/api/v1/pro/mock
Content-Type: application/json

{ "type": "person", "count": 5000, "locale": "en", "seed": 42 }

The bulk endpoint is metered per call with x402 (USDC on Base) — built for agents and CI pipelines that need thousands of rows in one request. Same response shape as the free endpoint.

Supported types

Why MockForge

GDPR-friendly by design

Every value is synthetic. No scraping, no real personal data — safe to commit, share and put in demos.

Internally consistent

A person's email comes from their own name; addresses line up. Records look real, not random noise.

Deterministic when you need it

Pass a seed and get the exact same data every time — perfect for tests.

New to seeding test data? Read the developer guide.