GET

/api/v1/{locale}/{generator}

Generate records of one type.

Parameters

Name	In	Required	Type / values	Description
locale	path	Yes	string, enum(es)	—
generator	path	Yes	string, enum(document · phone · identity · iban · card · passport · uuid · username · password)	—
count	query	No	integer, 1–1000, default: 1	—
seed	query	No	string	Same as the X-Seed header.
X-Seed	header	No	string	—
lang	query	No	string, enum(es · en), default: "es"	Language of the human-readable texts in the response (validation `reason`, error `message`, generator `label`). Takes precedence over the `Accept-Language` header; defaults to Spanish. Generated data is the same in every language.

Usage example

terminal

curl "https://datamockseed.firstflip.es/api/v1/es/document?sub=dni&ok=true&fmt=plain&count=2&seed=docs-ejemplo"

Example response

Generated when this page was built, with the same deterministic seed (docs-ejemplo).

{
  "status": "success",
  "meta": {
    "generator": "document",
    "locale": "es",
    "seed": "docs-ejemplo",
    "count": 2,
    "options": {
      "sub": "dni",
      "ok": "true",
      "fmt": "plain"
    }
  },
  "data": [
    {
      "documento": "29127292T",
      "tipo": "DNI"
    },
    {
      "documento": "61521712R",
      "tipo": "DNI"
    }
  ]
}

Try it live

Errors for this endpoint

400UNSUPPORTED_LOCALE
The `locale` in the URL is not supported (currently only "es").
404UNKNOWN_GENERATOR
The `generator` in the URL does not exist (`GET /generators` lists the valid ones).
400INVALID_PARAMS
A required parameter is missing or has an invalid value (e.g. "count").
413COUNT_LIMIT_EXCEEDED
"count" exceeds the maximum allowed by that endpoint.
429RATE_LIMIT_EXCEEDED
Your IP exceeded the requests-per-minute limit.

Full details in /en/docs/errors.