Skip to content
Utilerio
All endpoints

Test Data Generator

POST/api/v1/tools/mock-data-generator

Generate synthetic user, product or custom records as JSON, CSV or SQL, from a seed.

Authentication

Requires an API key in the X-API-Key header.

Try it

POST/api/v1/tools/mock-data-generator

Parameters

fieldsstringrequired

Field definitions: [{ name, type }]; type one of id, uuid, firstName, lastName, fullName, email, phone, address, city, country, company, jobTitle, boolean, integer, float, date, word, paragraph.

countintegeroptional

Rows to generate, 1–1000. Default 10.

localestringoptional

Locale for generated names/words. Default en.

entr
seedintegeroptional

Seed for deterministic output. Default 12345.

formatstringoptional

Output format. Default json.

jsoncsvsql
tableNamestringoptional

Table name when format is sql. Default table_name.

Request body

{
  "fields": [
    {
      "name": "id",
      "type": "id"
    },
    {
      "name": "name",
      "type": "fullName"
    },
    {
      "name": "email",
      "type": "email"
    }
  ],
  "count": 3,
  "locale": "en",
  "seed": 12345,
  "format": "json"
}

Response codes

  • 200Success.
  • 400Invalid request — check your body or parameters.
  • 401Missing or invalid API key.
  • 403The API key is not scoped to this endpoint.
  • 429Rate limit exceeded — retry after a short wait.

Language

cURL

Request

curl -X POST https://utilerio.com/api/v1/tools/mock-data-generator \
  -H "X-API-Key: YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{"fields":[{"name":"id","type":"id"},{"name":"name","type":"fullName"},{"name":"email","type":"email"}],"count":3,"locale":"en","seed":12345,"format":"json"}'

Response

{ "rows": [{ "id": 1, "name": "Grace Smith", "email": "grace.smith42@example.com" }], "rowCount": 3 }