Real Fake Data API Reference

Getting started

Quickstart

Every endpoint is a plain HTTPS GET request that returns a JSON envelope with a data record and a meta block. The example below fetches a single person name drawn from across the 27 EU countries — with no seed, so each call returns a fresh random record. Add a seed when you want the same record back every time, for stable test fixtures.

curl https://api.real-fake-data.com/v1/person-name

Getting started

Authentication

You don't need to authenticate to get started. The free tier is open — call any endpoint without an API key and IP-based rate limits apply. When you need higher limits or a private quota that isn't shared across an IP, add your API key in the Authorization header as a Bearer token. You can create and rotate keys from your dashboard.

Authorization: Bearer rfd_live_3f9a••••••2c71

Keep your secret keys server-side. Never embed a live key in client-side code or commit it to version control.

Getting started

The response envelope

Every generator endpoint returns the same outer shape: your record under `data`, and reproducibility metadata under `meta`. The per-endpoint reference below documents only the `data` fields — the envelope around them never changes, so read it once here.

{
  "data": { /* the generated record — shape varies by endpoint */ },
  "meta": {
    "seed": 7421,
    "generatorId": "any.person-name"
  }
}

• data holds the record you asked for. Its fields are endpoint-specific and are listed in that endpoint’s reference below.
• meta.seed is the seed that produced this record. Pass it back as ?seed= to get the exact same record again — deterministic replay is a core feature, ideal for stable test fixtures.
• meta.generatorId identifies which generator produced the record.
• meta is additive some endpoints add their own keys (for example sex on person endpoints, or format on formatted identifiers). Treat unknown meta keys as safe to ignore — new ones may appear without warning, so don’t write code that breaks when they do.

Request more than one record with ?count=N and the shape adjusts predictably: data becomes an array of records and meta gains a count. Everything else about the envelope is unchanged.

Reference

Errors & rate limits

Errors

A failed request returns a non-2xx status and a structured body. The error.code is a stable, machine-readable string you can branch on; error.message is a human-readable explanation, and error.details — present on validation failures — pinpoints the offending parameter.

{
  "error": {
    "code": "VALIDATION_ERROR",
    "message": "Invalid query parameters",
    "details": [
      { "path": "count", "message": "must be at most 10 on the free plan" }
    ]
  }
}

The Playwright addon surfaces these as a RealFakeDataError with status, code, details, so you can assert on them in tests.

Rate limits

• Free (no key): metered per IP at 60 requests/minute and 2,000 requests/month.
• Pro (API key): 600 requests/minute and 200,000 requests/month.
• Enterprise: self-hosted on your own infrastructure — no metering.

Every metered response carries the current rate window in its headers, and a 429 response adds Retry-After (seconds until the window resets):

RateLimit-Limit: <requests allowed per minute>
RateLimit-Remaining: <requests left in this minute>
RateLimit-Reset: <unix epoch seconds when the window resets>
Retry-After: <seconds to wait — on 429 responses only>

Read RateLimit-Remaining to pace yourself before you hit the limit; on a 429, wait Retry-After seconds and retry. Enterprise (self-hosted) responses are unmetered and carry no rate headers.

API reference

Query parameters

This endpoint takes no parameters.

curl https://api.real-fake-data.com/v1/generators

{
  "generators": [
    {
      "id": "any.person-name",
      "description": "Random realistic person name drawn from one or more EU countries",
      "supportedLocales": []
    },
    {
      "id": "pl.pesel",
      "description": "Random valid Polish PESEL (national identification number)",
      "supportedLocales": ["pl-PL"]
    }
    // …217 generators in total
  ]
}

API reference

Query parameters

This endpoint takes no parameters.

curl https://api.real-fake-data.com/v1/health

{
  "status": "ok",
  "version": "0.0.0",
  "uptime": 3812.47
}

API reference

Returns an auto-increment integer — the classic SQL primary key. A single request returns `start` (default 1); a batch (`count`) returns the run `start, start + step, start + 2·step, …` (default `step` 1). Deterministic by construction — the output depends only on `start`, `step`, and position, not on the seed.

Query parameters

curl https://api.real-fake-data.com/v1/sequence

API reference

Returns a realistic synthetic company name drawn from a mix of EU countries. Pass `countries` as a comma-separated list of ISO codes (`?countries=pl,de,it`) and each record is generated by one of them, picked at random — so a batch can mix Polish, German, and Italian firm names, each with its own legal form. Omit `countries` for all 27. Each record reports its `country`. `strategy` and `edge` work as on the per-country endpoints.

Query parameters

curl https://api.real-fake-data.com/v1/company-name

API reference

Returns a random member drawn from a user-supplied weighted enumeration — a JSON map of `member → relative weight` in the `choices` param. Weights need not sum to 1; they are normalized by their total, so `{"a":1,"b":4}` and `{"a":0.2,"b":0.8}` are the same distribution. `choices` must be sent as URL-encoded JSON. An empty map, or weights that are all zero, negative, or non-finite, is a 400. `edge=true` inverts the distribution (Pro), `extreme=true` returns a hostile-encoded value (Pro), and `invalid=true` returns a value not in `choices` with probability 0.

Query parameters

curl https://api.real-fake-data.com/v1/enum

API reference

Returns a random object drawn from a user-supplied weighted list — a JSON array of `{ object, weight }` candidates in the `choices` param — returned verbatim. The object counterpart to `/v1/enum`. Weights need not sum to 1; they are normalized by their total. `choices` must be sent as URL-encoded JSON. An empty list, weights that are all zero / negative / non-finite, or a candidate whose serialized JSON is over-large, is a 400. `edge=true` inverts the distribution (Pro), `extreme=true` returns a hostile-encoded value (Pro), and `invalid=true` returns a sentinel object not among `choices` with probability 0.

Query parameters

curl https://api.real-fake-data.com/v1/object

API reference

Returns a realistic synthetic email address drawn from a mix of EU countries. Pass `countries` as a comma-separated list of ISO codes (`?countries=pl,de,it`) and each record is generated by one of them, picked at random — so a batch can mix Polish, German, and Italian addresses, each with its own regional providers and corporate TLDs. Omit `countries` for all 27; each record reports its `country`. `domain` pins an exact domain; `domainCategory` (`free`/`regional`/`corporate`/`any`) scopes a weighted-random draw. `pattern` selects the local-part shape (`first.last`, `first.company`, …) or `any`. `plusTag` controls plus-addressing — `true` always adds a random tag, `false` never, any other value is the tag verbatim. `exotic=true` opts in to the rarer RFC-valid local-part characters.

Query parameters

curl https://api.real-fake-data.com/v1/email

API reference

Returns classic "Lorem ipsum…" placeholder text. The size is set by one of `bytes`, `chars`, `words`, or `paragraphs` — when more than one is given the most precise wins, in that order. With none given a few paragraphs are returned. `bytes`/`chars` cut on an exact boundary (the final word may be clipped); `words`/`paragraphs` end on a whole sentence. `startWithLorem=false` starts from a random word instead of the canonical opening.

Query parameters

curl https://api.real-fake-data.com/v1/lorem

API reference

Returns a synthetic MongoDB ObjectId — a well-formed 24-character hex string. The value is derived entirely from the seed (timestamp and counter regions are synthetic, not wall-clock), so the same seed always reproduces the same id.

Query parameters

curl https://api.real-fake-data.com/v1/object-id

API reference

Returns a synthetic Nano ID — a compact URL-safe identifier. `size` sets the length (default 21); `alphabet` overrides the default URL-safe 64-character set. Output is derived from the seed, so the same seed and params always reproduce the same id.

Query parameters

curl https://api.real-fake-data.com/v1/nanoid

API reference

Returns a realistic synthetic person name drawn from a mix of EU countries. Pass `countries` as a comma-separated list of ISO codes (`?countries=pl,sk,it`) and each record is generated by one of them, picked at random — so a batch can mix Polish, Slovak, and Italian names, each in its own local form. Omit `countries` to draw from all 27 EU countries. Each record reports the `country` it came from. `sex`, `edge`, and `caseStrict` work as on the per-country endpoints.

Query parameters

curl https://api.real-fake-data.com/v1/person-name

API reference

Returns a realistic synthetic offering drawn from a mix of EU countries. Pass `countries` as a comma-separated list of ISO codes (`?countries=pl,de,it`) and each record is generated by one of them, picked at random — so a batch mixes localized offerings from several countries. Omit `countries` to draw from all 27. Each record reports the `country` it came from. `industry`, `type`, `industryName`/`offeringName` full-text filters, and `edge`/`extreme`/`invalid` work as on the per-country endpoints.

Query parameters

curl https://api.real-fake-data.com/v1/offering

API reference

Returns a random string that matches the supplied regular expression (`pattern`) — for seeding data whose format the catalog does not model, such as in-house serial numbers or SKUs. `maxRepetition` caps how many times unbounded quantifiers (`*`, `+`, `{n,}`) expand. Back-references, look-around assertions, and patterns with an over-large worst-case expansion are rejected. This endpoint requires the Pro plan or above. Percent-encode reserved characters in `pattern` — most importantly `+` must be sent as `%2B`, since a literal `+` in a query string decodes to a space.

Query parameters

curl https://api.real-fake-data.com/v1/custom-regex

API reference

Returns a synthetic ULID — a 26-character Crockford-Base32 identifier. The leading timestamp is derived from the seed, not the wall clock, so the same seed always reproduces the same id.

Query parameters

curl https://api.real-fake-data.com/v1/ulid

API reference

Returns a synthetic UUID. `version=4` (default) is fully random; `version=7` is time-ordered per RFC 9562. The v7 timestamp is derived from the seed, not the wall clock, so the same seed always reproduces the same id.

Query parameters

curl https://api.real-fake-data.com/v1/uuid

API reference

Returns a consistent synthetic Austrian company in one call: a full trading name with its legal form, plus the matching firmenbuchnummer, uid, steuernummer. Shape the name with `strategy` and `legalForm` (as on `/v1/at/company-name`). Set `invalid=true` to corrupt the checksummed identifiers (the name stays intact), for testing checksum validators.

Query parameters

curl https://api.real-fake-data.com/v1/at/company

API reference

Returns a realistic synthetic Austrian company name across the naming families (coined, owner-surname, descriptive, modern), with an optional trailing legal form in its authentic local form. Pin `strategy` or `legalForm`, set `legalForm=none` to omit it, or `edge=true` for the punctuation-heavy / long-form corners.

Query parameters

curl https://api.real-fake-data.com/v1/at/company-name

API reference

Returns a realistic synthetic Austrian email address: a name-based local part (romanised to ASCII) on a free webmail, a Austrian regional provider, or a corporate domain built from a Austrian company brand. `domain` pins an exact domain; `domainCategory` (`free`/`regional`/`corporate`/`any`) scopes a weighted-random draw. `pattern` selects the local-part shape or `any`. `plusTag` controls plus-addressing; `exotic=true` allows the rarer RFC-valid characters.

Query parameters

curl https://api.real-fake-data.com/v1/at/email

API reference

Returns a valid Austrian Firmenbuchnummer (commercial-register number) with a correct check letter, e.g. `FN 123456a`. Set `invalid=true` for a deliberately wrong check letter.

Query parameters

curl https://api.real-fake-data.com/v1/at/firmenbuchnummer

API reference

Returns a valid Austrian IBAN with a correct checksum. Pin the issuing bank with `bankCode` (5-digit bank code) or `bankName` (mutually exclusive), or let it be chosen at random. Set `invalid=true` to get an IBAN with deliberately wrong check digits, for testing checksum validators.

Query parameters

curl https://api.real-fake-data.com/v1/at/iban

API reference

Returns a synthetic Austrian person: given name(s), surname, initials, birth date, and the matching SVNR. Constrain with `sex` and age/birth-date filters (contradictory combinations are rejected with a 400). Set `invalid=true` for a deliberately wrong check value, `edge=true` for rare-corner values, and `caseStrict=false` to mangle the name casing.

Query parameters

curl https://api.real-fake-data.com/v1/at/person

API reference

Returns a realistic synthetic Austrian person name: given name(s), surname, and initials, in the local script. Use `sex` to pin the gendered form (`m`/`f`) or omit it for a random one. `edge=true` biases the name shape — second given names, double-barrelled surnames, and very short names become far more likely. Set `caseStrict=false` to deliberately mangle the name/surname casing (initials stay proper uppercase).

Query parameters

curl https://api.real-fake-data.com/v1/at/person-name

API reference

Returns a realistic synthetic Austrian offering — a product or service with a localized name, a plausible EUR price, its unit, and its industry label. Pin `industry` (NACE code), `type` (product/service), or filter by `industryName`/`offeringName` full text. Set `edge=true` for the price/format corners, `extreme=true` for a hostile-encoded name, or `invalid=true` for a broken record.

Query parameters

curl https://api.real-fake-data.com/v1/at/offering

API reference

Returns a format-valid Austrian Steuernummer (tax number), e.g. `12-345/6789`. The Steuernummer has no uniform checksum, so it is format-only — there is no `invalid` flag.

Query parameters

curl https://api.real-fake-data.com/v1/at/steuernummer

API reference

Returns a valid Austrian SVNR (Sozialversicherungsnummer) with a correct check digit. Constrain with age/birth-date filters (the SVNR encodes a birth date but no sex). Contradictory combinations are rejected with a 400. Set `invalid=true` for a deliberately wrong check digit.

Query parameters

curl https://api.real-fake-data.com/v1/at/svnr

API reference

Returns a valid Austrian UID (Umsatzsteuer-Identifikationsnummer) with a correct check digit. Use `format=vat` for the intra-EU `AT`-prefixed form. Set `invalid=true` for a UID with a deliberately wrong check digit.

Query parameters

curl https://api.real-fake-data.com/v1/at/uid

API reference

Returns a realistic Austrian vehicle registration plate. `type` selects the kind: `standard` (default, `<DISTRICT> NNN LL`, e.g. GU 234 KP), `custom` (reversed Wunschkennzeichen, letters-first then a digit, e.g. W ABC 1), `motorcycle` (same district code + sequence), `military` (`BH NNNN`), `police` (`BP NNNN`), or `diplomatic` (`<state>D NNN`, e.g. WD 123). For the region-encoding types, `district` and `state` narrow the head code, matched by name (an unknown district, state, or pair is a 400); military/police ignore them. Austrian plates carry no checksum, so there is no invalid variant. Use `format` to choose spaced or compact rendering.

Query parameters

curl https://api.real-fake-data.com/v1/at/vehicle-registration

API reference

Returns a consistent synthetic Belgian company in one call: a full trading name with its legal form, plus the matching ondernemingsnummer. Shape the name with `strategy` and `legalForm` (as on `/v1/be/company-name`). Set `invalid=true` to corrupt the checksummed identifiers (the name stays intact), for testing checksum validators.

Query parameters

curl https://api.real-fake-data.com/v1/be/company

API reference

Returns a realistic synthetic Belgian company name across the naming families (coined, owner-surname, descriptive, modern), with an optional trailing legal form in its authentic local form. Pin `strategy` or `legalForm`, set `legalForm=none` to omit it, or `edge=true` for the punctuation-heavy / long-form corners.

Query parameters

curl https://api.real-fake-data.com/v1/be/company-name

API reference

Returns a realistic synthetic Belgian email address: a name-based local part (romanised to ASCII) on a free webmail, a Belgian regional provider, or a corporate domain built from a Belgian company brand. `domain` pins an exact domain; `domainCategory` (`free`/`regional`/`corporate`/`any`) scopes a weighted-random draw. `pattern` selects the local-part shape or `any`. `plusTag` controls plus-addressing; `exotic=true` allows the rarer RFC-valid characters.

Query parameters

curl https://api.real-fake-data.com/v1/be/email

API reference

Returns a valid Belgian IBAN with a correct checksum. Pin the issuing bank with `bankCode` (3-digit bank code) or `bankName` (mutually exclusive), or let it be chosen at random. Set `invalid=true` to get an IBAN with deliberately wrong check digits, for testing checksum validators.

Query parameters

curl https://api.real-fake-data.com/v1/be/iban

API reference

Returns a valid Belgian Ondernemingsnummer (enterprise number) with a correct `97 − (first8 mod 97)` check. Use `format=vat` for the BE VAT number. Set `invalid=true` for a number with a deliberately wrong check.

Query parameters

curl https://api.real-fake-data.com/v1/be/ondernemingsnummer

API reference

Returns a synthetic Belgian person: given name(s), surname, initials, birth date, and the matching national register number (RRN). Constrain with `sex` and age/birth-date filters (contradictory combinations are rejected with a 400). Set `invalid=true` for a deliberately wrong check value, `edge=true` for rare-corner values, and `caseStrict=false` to mangle the name casing.

Query parameters

curl https://api.real-fake-data.com/v1/be/person

API reference

Returns a realistic synthetic Belgian person name: given name(s), surname, and initials, in the local script. Use `sex` to pin the gendered form (`m`/`f`) or omit it for a random one. `edge=true` biases the name shape — second given names, double-barrelled surnames, and very short names become far more likely. Set `caseStrict=false` to deliberately mangle the name/surname casing (initials stay proper uppercase).

Query parameters

curl https://api.real-fake-data.com/v1/be/person-name

API reference

Returns a realistic synthetic Belgian offering — a product or service with a localized name, a plausible EUR price, its unit, and its industry label. Belgium is trilingual: without a pinned `language`, names draw from the weighted nl/fr/de mix. Pin `industry` (NACE code), `type` (product/service), or filter by `industryName`/`offeringName` full text. Set `edge=true` for the price/format corners, `extreme=true` for a hostile-encoded name, or `invalid=true` for a deliberately broken record.

Query parameters

curl https://api.real-fake-data.com/v1/be/offering

API reference

Returns a valid Belgian Rijksregisternummer (RRN) with correct check digits. Constrain with `sex` and age/birth-date filters (the full birth date is encoded). Use `kind=bis` for a BIS-number. Contradictory combinations are rejected with a 400. Set `invalid=true` for deliberately wrong check digits.

Query parameters

curl https://api.real-fake-data.com/v1/be/rijksregisternummer

API reference

Returns a realistic Belgian vehicle registration plate. `type` selects the kind: `standard` (default, `N-LLL-NNN`, e.g. 1-ABC-123), `custom` (personalised vanity plate), `motorcycle` (`M-…`), `moped` (`S-…`), `diplomatic` (`CD-…`), `dealer` (`Z`-series), `export` (`X`-series with a year), `oldtimer` (`O`-series), `taxi` (`TX`-series), or `trailer` (`Q`-series). Belgian plates are national (no region) and carry no checksum, so there is no `invalid` variant. Use `format` to choose hyphenated, spaced, or compact rendering.

Query parameters

curl https://api.real-fake-data.com/v1/be/vehicle-registration

API reference

Returns a consistent synthetic Bulgarian company in one call: a full trading name with its legal form, plus the matching eik. Shape the name with `strategy` and `legalForm` (as on `/v1/bg/company-name`). Set `invalid=true` to corrupt the checksummed identifiers (the name stays intact), for testing checksum validators.

Query parameters

curl https://api.real-fake-data.com/v1/bg/company

API reference

Returns a realistic synthetic Bulgarian company name across the naming families (coined, owner-surname, descriptive, modern), with an optional trailing legal form in its authentic local form. Pin `strategy` or `legalForm`, set `legalForm=none` to omit it, or `edge=true` for the punctuation-heavy / long-form corners.

Query parameters

curl https://api.real-fake-data.com/v1/bg/company-name

API reference

Returns a valid Bulgarian EGN (Единен граждански номер, the unified civil number) with a correct check digit. Constrain with `sex` and age/birth-date filters (the full birth date is encoded). Contradictory combinations are rejected with a 400. Set `invalid=true` for a deliberately wrong check digit.

Query parameters

curl https://api.real-fake-data.com/v1/bg/egn

API reference

Returns a valid Bulgarian EIK (Единен идентификационен код, the company/Bulstat number) with a correct two-stage check digit. Use `format=vat` for the BG VAT number (`BG` + EIK). Set `invalid=true` for an EIK with a deliberately wrong check digit.

Query parameters

curl https://api.real-fake-data.com/v1/bg/eik

API reference

Returns a realistic synthetic Bulgarian email address: a name-based local part (romanised to ASCII) on a free webmail, a Bulgarian regional provider, or a corporate domain built from a Bulgarian company brand. `domain` pins an exact domain; `domainCategory` (`free`/`regional`/`corporate`/`any`) scopes a weighted-random draw. `pattern` selects the local-part shape or `any`. `plusTag` controls plus-addressing; `exotic=true` allows the rarer RFC-valid characters.

Query parameters

curl https://api.real-fake-data.com/v1/bg/email

API reference

Returns a valid Bulgarian IBAN with a correct checksum. Pin the issuing bank with `bankCode` (4-letter bank code) or `bankName` (mutually exclusive), or let it be chosen at random. Set `invalid=true` to get an IBAN with deliberately wrong check digits, for testing checksum validators.

Query parameters

curl https://api.real-fake-data.com/v1/bg/iban

API reference

Returns a synthetic Bulgarian person: given name(s), surname, initials, birth date, and the matching EGN. Constrain with `sex` and age/birth-date filters (contradictory combinations are rejected with a 400). Set `invalid=true` for a deliberately wrong check value, `edge=true` for rare-corner values, and `caseStrict=false` to mangle the name casing.

Query parameters

curl https://api.real-fake-data.com/v1/bg/person

API reference

Returns a realistic synthetic Bulgarian person name: given name(s), surname, and initials, in the local script. Use `sex` to pin the gendered form (`m`/`f`) or omit it for a random one. `edge=true` biases the name shape — second given names, double-barrelled surnames, and very short names become far more likely. Set `caseStrict=false` to deliberately mangle the name/surname casing (initials stay proper uppercase).

Query parameters

curl https://api.real-fake-data.com/v1/bg/person-name

API reference

Returns a realistic synthetic Bulgarian offering — a product or service with a localized name, a plausible EUR price, its unit, and its industry label. Pin `industry` (NACE code), `type` (product/service), or filter by `industryName`/`offeringName` full text. Set `edge=true` for the price/format corners, `extreme=true` for a hostile-encoded name, or `invalid=true` for a broken record.

Query parameters

curl https://api.real-fake-data.com/v1/bg/offering

API reference

Returns a realistic Bulgarian vehicle registration plate. `type` selects the kind: `standard` (default, `L(L) NNNN LL`, e.g. CB 4821 KH), `custom` (vanity tail, same shape), `motorcycle` (`L(L) NNNN L`), `military` (`BA NNN NNN`, no province), `diplomatic` (Sofia `C`/`CC`/`CT` blocks), `electric` (`EA NNNN LL`), or `temporary` (`NNN L NNN`). Real plates are Cyrillic but restricted to the twelve Latin-lookalike glyphs, so `script` emits the interoperable `latin` form (default) or the real Cyrillic (`native`). Region-encoding types can be pinned to a province via `province` (an unknown name is a 400). No plate carries a checksum, so there is no `invalid` variant. Use `format` to choose spaced or compact rendering.

Query parameters

curl https://api.real-fake-data.com/v1/bg/vehicle-registration

API reference

Takes a JSON skeleton whose fields are marked with `$`-sources (`$generator.*`, `$alias.*`, `$shared.*`, `$date.*`) and returns the same skeleton filled with mutually consistent, valid values — a whole record in one request, for mock servers and DB seeding. `$count` turns a node into an array; `$generators` / `shared` keep several fields describing the same entity; `$anchor` relates dates across a record. Deterministic when a `seed` is given. Requires the Pro plan. See the request-shape guide for the full grammar.

Query parameters

This endpoint takes no parameters.

curl https://api.real-fake-data.com/v1/compose

API reference

Returns a consistent synthetic Croatian company in one call: a full trading name with its legal form, plus the matching oib. Shape the name with `strategy` and `legalForm` (as on `/v1/hr/company-name`). Set `invalid=true` to corrupt the checksummed identifiers (the name stays intact), for testing checksum validators.

Query parameters

curl https://api.real-fake-data.com/v1/hr/company

API reference

Returns a realistic synthetic Croatian company name across the naming families (coined, owner-surname, descriptive, modern), with an optional trailing legal form in its authentic local form. Pin `strategy` or `legalForm`, set `legalForm=none` to omit it, or `edge=true` for the punctuation-heavy / long-form corners.

Query parameters

curl https://api.real-fake-data.com/v1/hr/company-name

API reference

Returns a realistic synthetic Croatian email address: a name-based local part (romanised to ASCII) on a free webmail, a Croatian regional provider, or a corporate domain built from a Croatian company brand. `domain` pins an exact domain; `domainCategory` (`free`/`regional`/`corporate`/`any`) scopes a weighted-random draw. `pattern` selects the local-part shape or `any`. `plusTag` controls plus-addressing; `exotic=true` allows the rarer RFC-valid characters.

Query parameters

curl https://api.real-fake-data.com/v1/hr/email

API reference

Returns a valid Croatian IBAN with a correct checksum. Pin the issuing bank with `bankCode` (7-digit VBDI code) or `bankName` (mutually exclusive), or let it be chosen at random. Set `invalid=true` to get an IBAN with deliberately wrong check digits, for testing checksum validators.

Query parameters

curl https://api.real-fake-data.com/v1/hr/iban

API reference

Returns a historically well-formed Croatian JMBG (replaced by the OIB in 2009) with a correct mod-11 check. Constrain with `sex` and age/birth-date filters; the JMBG encodes the full birth date. Contradictory combinations are rejected with a 400. Set `invalid=true` for a deliberately failing check.

Query parameters

curl https://api.real-fake-data.com/v1/hr/jmbg

API reference

Returns a valid Croatian OIB (the single identifier for both persons and companies) with a correct ISO 7064 MOD 11,10 check digit. Use `format` for the HR VAT number. Set `invalid=true` for an OIB with a deliberately wrong check digit.

Query parameters

curl https://api.real-fake-data.com/v1/hr/oib

API reference

Returns a synthetic Croatian person: given name(s), surname, initials, birth date, and the matching JMBG. Constrain with `sex` and age/birth-date filters (contradictory combinations are rejected with a 400). Set `invalid=true` for a deliberately wrong check value, `edge=true` for rare-corner values, and `caseStrict=false` to mangle the name casing.

Query parameters

curl https://api.real-fake-data.com/v1/hr/person

API reference

Returns a realistic synthetic Croatian person name: given name(s), surname, and initials, in the local script. Use `sex` to pin the gendered form (`m`/`f`) or omit it for a random one. `edge=true` biases the name shape — second given names, double-barrelled surnames, and very short names become far more likely. Set `caseStrict=false` to deliberately mangle the name/surname casing (initials stay proper uppercase).

Query parameters

curl https://api.real-fake-data.com/v1/hr/person-name

API reference

Returns a realistic synthetic Croatian offering — a product or service with a localized name, a plausible EUR price, its unit, and its industry label. Pin `industry` (NACE code), `type` (product/service), or filter by `industryName`/`offeringName` full text. Set `edge=true` for the price/format corners, `extreme=true` for a hostile-encoded name, or `invalid=true` for a broken record.

Query parameters

curl https://api.real-fake-data.com/v1/hr/offering

API reference

Returns a realistic Croatian vehicle registration plate. `type` selects the kind: `standard` (default, `LL NNN(N)-L(L)`, e.g. ZG 123-AB), `custom` (vanity word plate), `military` (`HV NNN-L(L)`), `diplomatic` (`NNN-X-NNN`), `export` (`RH NNNN-L`), `historic` (`LL-PV-NNN`), or `motorcycle`. The region-coded types (standard, custom, motorcycle) carry a real two-letter city code and can be pinned to an issuing city via `city` (diacritic-sensitive; an unknown city is a 400). No Croatian plate carries a checksum, so there is no `invalid` variant. Use `format` to choose spaced or compact rendering.

Query parameters

curl https://api.real-fake-data.com/v1/hr/vehicle-registration

API reference

Returns a consistent synthetic Cypriot company in one call: a full trading name with its legal form, plus the matching tic. Shape the name with `strategy` and `legalForm` (as on `/v1/cy/company-name`). Set `invalid=true` to corrupt the checksummed identifiers (the name stays intact), for testing checksum validators.

Query parameters

curl https://api.real-fake-data.com/v1/cy/company

API reference

Returns a realistic synthetic Cypriot company name across the naming families (coined, owner-surname, descriptive, modern), with an optional trailing legal form in its authentic local form. Pin `strategy` or `legalForm`, set `legalForm=none` to omit it, or `edge=true` for the punctuation-heavy / long-form corners.

Query parameters

curl https://api.real-fake-data.com/v1/cy/company-name

API reference

Returns a realistic synthetic Cypriot email address: a name-based local part (romanised to ASCII) on a free webmail, a Cypriot regional provider, or a corporate domain built from a Cypriot company brand. `domain` pins an exact domain; `domainCategory` (`free`/`regional`/`corporate`/`any`) scopes a weighted-random draw. `pattern` selects the local-part shape or `any`. `plusTag` controls plus-addressing; `exotic=true` allows the rarer RFC-valid characters.

Query parameters

curl https://api.real-fake-data.com/v1/cy/email

API reference

Returns a valid Cypriot IBAN with a correct checksum. Pin the issuing bank with `bankCode` (3-digit bank code) or `bankName` (mutually exclusive), or let it be chosen at random. Set `invalid=true` to get an IBAN with deliberately wrong check digits, for testing checksum validators.

Query parameters

curl https://api.real-fake-data.com/v1/cy/iban

API reference

Returns a synthetic Cypriot person: given name(s), surname, initials, birth date, and the matching TIC. Constrain with `sex` and age/birth-date filters (contradictory combinations are rejected with a 400). Set `invalid=true` for a deliberately wrong check value, `edge=true` for rare-corner values, and `caseStrict=false` to mangle the name casing.

Query parameters

curl https://api.real-fake-data.com/v1/cy/person

API reference

Returns a realistic synthetic Cypriot person name: given name(s), surname, and initials, in the local script. Use `sex` to pin the gendered form (`m`/`f`) or omit it for a random one. `edge=true` biases the name shape — second given names, double-barrelled surnames, and very short names become far more likely. Set `caseStrict=false` to deliberately mangle the name/surname casing (initials stay proper uppercase).

Query parameters

curl https://api.real-fake-data.com/v1/cy/person-name

API reference

Returns a realistic synthetic Cypriot offering — a product or service with a localized name, a plausible EUR price, its unit, and its industry label. Pin `industry` (NACE code), `type` (product/service), or filter by `industryName`/`offeringName` full text. Set `edge=true` for the price/format corners, `extreme=true` for a hostile-encoded name, or `invalid=true` for a broken record.

Query parameters

curl https://api.real-fake-data.com/v1/cy/offering

API reference

Returns a realistic Cypriot vehicle registration plate. `type` selects the kind: `standard` (default, national sequential `LLL NNN`, e.g. KAB 417), `motorcycle` (reuses the standard mask), `diplomatic` (`NN CD NNN`), `trailer` (`P00 NNN`), `un` (`UN-NNN`), or `sba` (`SBAA-NN`). Cyprus encodes no region, issues no vanity plates, and no plate carries a checksum, so there is no `invalid` variant. Use `format` to choose spaced or compact rendering (ignored for `un`/`sba`, whose hyphen is intrinsic).

Query parameters

curl https://api.real-fake-data.com/v1/cy/vehicle-registration

API reference

Returns a valid Cyprus TIC (Tax Identification Code) — 8 digits plus a correct check letter. Use `format=vat` for the CY VAT number (`CY` + TIC). Set `invalid=true` for a TIC with a deliberately wrong check letter.

Query parameters

curl https://api.real-fake-data.com/v1/cy/tic

API reference

Returns a consistent synthetic Czech company in one call: a full trading name with its legal form, plus the matching ico. Shape the name with `strategy` and `legalForm` (as on `/v1/cz/company-name`). Set `invalid=true` to corrupt the checksummed identifiers (the name stays intact), for testing checksum validators.

Query parameters

curl https://api.real-fake-data.com/v1/cz/company

API reference

Returns a realistic synthetic Czech company name across the naming families (coined, owner-surname, descriptive, modern), with an optional trailing legal form in its authentic local form. Pin `strategy` or `legalForm`, set `legalForm=none` to omit it, or `edge=true` for the punctuation-heavy / long-form corners.

Query parameters

curl https://api.real-fake-data.com/v1/cz/company-name

API reference

Returns a realistic synthetic Czech email address: a name-based local part (romanised to ASCII) on a free webmail, a Czech regional provider, or a corporate domain built from a Czech company brand. `domain` pins an exact domain; `domainCategory` (`free`/`regional`/`corporate`/`any`) scopes a weighted-random draw. `pattern` selects the local-part shape or `any`. `plusTag` controls plus-addressing; `exotic=true` allows the rarer RFC-valid characters.

Query parameters

curl https://api.real-fake-data.com/v1/cz/email

API reference

Returns a valid Czech IBAN with a correct checksum. Pin the issuing bank with `bankCode` (4-digit bank code) or `bankName` (mutually exclusive), or let it be chosen at random. Set `invalid=true` to get an IBAN with deliberately wrong check digits, for testing checksum validators.

Query parameters

curl https://api.real-fake-data.com/v1/cz/iban

API reference

Returns a valid Czech IČO (business identification number) with a correct mod-11 check digit. Use `format=vat` for the `CZ`-prefixed VAT number (DIČ). Set `invalid=true` for an IČO with a deliberately wrong check digit.

Query parameters

curl https://api.real-fake-data.com/v1/cz/ico

API reference

Returns a synthetic Czech person: given name(s), surname, initials, birth date, and the matching rodné číslo. Constrain with `sex` and age/birth-date filters (contradictory combinations are rejected with a 400). Set `invalid=true` for a deliberately wrong check value, `edge=true` for rare-corner values, and `caseStrict=false` to mangle the name casing.

Query parameters

curl https://api.real-fake-data.com/v1/cz/person

API reference

Returns a realistic synthetic Czech person name: given name(s), surname, and initials, in the local script. Use `sex` to pin the gendered form (`m`/`f`) or omit it for a random one. `edge=true` biases the name shape — second given names, double-barrelled surnames, and very short names become far more likely. Set `caseStrict=false` to deliberately mangle the name/surname casing (initials stay proper uppercase).

Query parameters

curl https://api.real-fake-data.com/v1/cz/person-name

API reference

Returns a realistic synthetic Czech offering — a product or service with a localized name, a plausible EUR price, its unit, and its industry label. Pin `industry` (NACE code), `type` (product/service), or filter by `industryName`/`offeringName` full text. Set `edge=true` for the price/format corners, `extreme=true` for a hostile-encoded name, or `invalid=true` for a broken record.

Query parameters

curl https://api.real-fake-data.com/v1/cz/offering

API reference

Returns a valid Czech rodné číslo (birth number) divisible by 11. Constrain with `sex` and age/birth-date filters (the full birth date is encoded). Contradictory combinations are rejected with a 400. Use `format` for the `YYMMDD/SSSC` slash rendering. Set `invalid=true` for a deliberately wrong divisibility check.

Query parameters

curl https://api.real-fake-data.com/v1/cz/rodne-cislo

API reference

Returns a realistic Czech vehicle registration plate. `type` selects the kind: `standard` (default, `NLN NNNN`, e.g. 1A2 3456, whose second character encodes the region/kraj), `extended` (`NLL NNNN` two-letter overflow), `custom` (2016+ vanity), `motorcycle`, `diplomatic` (CD), `historic` (V marker), `electric` (EL prefix), or `military` (digits only). `region` restricts a standard/extended plate to a named kraj (e.g. Prague, South Moravia); an unknown kraj is a 400, and the filter is ignored for the region-agnostic classes. Czech plates carry no checksum, so there is no invalid variant. Use `format` to choose spaced or compact rendering.

Query parameters

curl https://api.real-fake-data.com/v1/cz/vehicle-registration

API reference

Returns a consistent synthetic Danish company in one call: a full trading name with its legal form, plus the matching CVR number. Shape the name with `strategy` and `legalForm` (as on `/v1/dk/company-name`). Set `invalid=true` to corrupt the CVR check digit (the name stays intact), for testing checksum validators.

Query parameters

curl https://api.real-fake-data.com/v1/dk/company

API reference

Returns a realistic synthetic Danish company name across the naming families (coined, owner-surname, descriptive, modern), with an optional trailing legal form in its authentic local form. Pin `strategy` or `legalForm`, set `legalForm=none` to omit it, or `edge=true` for the punctuation-heavy / long-form corners.

Query parameters

curl https://api.real-fake-data.com/v1/dk/company-name

API reference

Returns a valid Danish CPR (Det Centrale Personregister) number. Constrain with `sex` and age/birth-date filters (the full date is encoded). Contradictory combinations are rejected with a 400. Use `checksum` to choose the mod-11 standard, `format` for the rendering, and `invalid=true` for a deliberately wrong check.

Query parameters

curl https://api.real-fake-data.com/v1/dk/cpr

API reference

Returns a valid Danish CVR (company identifier) with a correct mod-11 check digit. Use `format=vat` for the DK VAT number (`DK` + CVR). Set `invalid=true` for a CVR with a deliberately wrong check digit.

Query parameters

curl https://api.real-fake-data.com/v1/dk/cvr

API reference

Returns a realistic synthetic Danish email address: a name-based local part (romanised to ASCII) on a free webmail, a Danish regional provider, or a corporate domain built from a Danish company brand. `domain` pins an exact domain; `domainCategory` (`free`/`regional`/`corporate`/`any`) scopes a weighted-random draw. `pattern` selects the local-part shape or `any`. `plusTag` controls plus-addressing; `exotic=true` allows the rarer RFC-valid characters.

Query parameters

curl https://api.real-fake-data.com/v1/dk/email

API reference

Returns a valid Danish IBAN with a correct checksum. Pin the issuing bank with `bankCode` (4-digit bank code) or `bankName` (mutually exclusive), or let it be chosen at random. Set `invalid=true` to get an IBAN with deliberately wrong check digits, for testing checksum validators.

Query parameters

curl https://api.real-fake-data.com/v1/dk/iban

API reference

Returns a mutually consistent synthetic Danish person: given name(s), surname, initials, birth date, and a matching CPR. Takes the same inputs as `/v1/dk/cpr` — `sex`, any combination of age/birth-date filters, `checksum`, and `format` (contradictory combinations are rejected with a 400). Set `invalid=true` for a person whose CPR has a deliberately wrong mod-11 check (birth date and sex stay valid). `edge=true` also makes second given names and double-barrelled surnames far more likely. Set `caseStrict=false` to deliberately mangle the name/surname casing.

Query parameters

curl https://api.real-fake-data.com/v1/dk/person

API reference

Returns a realistic synthetic Danish person name: given name(s), surname, and initials, in the local script. Use `sex` to pin the gendered form (`m`/`f`) or omit it for a random one. `edge=true` biases the name shape — second given names, double-barrelled surnames, and very short names become far more likely. Set `caseStrict=false` to deliberately mangle the name/surname casing (initials stay proper uppercase).

Query parameters

curl https://api.real-fake-data.com/v1/dk/person-name

API reference

Returns a realistic synthetic Danish offering — a product or service with a localized name, a plausible EUR price, its unit, and its industry label. Pin `industry` (NACE code), `type` (product/service), or filter by `industryName`/`offeringName` full text. Set `edge=true` for the price/format corners, `extreme=true` for a hostile-encoded name, or `invalid=true` for a broken record.

Query parameters

curl https://api.real-fake-data.com/v1/dk/offering

API reference

Returns a realistic Danish vehicle registration plate. `type` selects the kind: `standard` (default, `LL NNNNN` rendered `LL NN NNN`, e.g. AB 12 345), `custom` (a 1–7 character vanity plate over `A–Z Æ Ø Å 0–9`), `diplomatic` (`LL 76NNN`/`LL 77NNN`), `trailer` (`LL NNNN`), `motorcycle` (same mask as standard), or `export` (`[YY]NNNNN`). `era` exposes the divergent 1950s single-letter `L NNNNN` legacy form (`current` default, `legacy`, or `both`), and applies only to the standard/motorcycle masks. Denmark encodes no region and no plate carries a checksum, so there is no `invalid` variant. Use `format` to choose spaced or compact rendering.

Query parameters

curl https://api.real-fake-data.com/v1/dk/vehicle-registration

API reference

Returns a valid Dutch BSN (Burgerservicenummer) with a correct elfproef check. The BSN is non-semantic — it encodes no birth date or sex. Set `invalid=true` for a BSN with a deliberately wrong check digit, or `edge=true` for valid edge-case numbers.

Query parameters

curl https://api.real-fake-data.com/v1/nl/bsn

API reference

Returns a valid Dutch btw-id (VAT identification number), e.g. `NL123456789B01`. Use `standard` to pick `modern` (default, MOD 97-10 checked) or `legacy` (elfproef core, `B01` suffix). Set `invalid=true` for a btw-id that fails validation, or `edge=true` for valid edge-case numbers.

Query parameters

curl https://api.real-fake-data.com/v1/nl/btw-id

API reference

Returns a consistent synthetic Dutch company in one call: a full trading name with its legal form, plus the matching KvK, RSIN, and btw-id. Shape the name with `strategy` and `legalForm` (as on `/v1/nl/company-name`). Set `invalid=true` to corrupt the RSIN and btw-id check digits (the KvK number has no checksum and the name stays intact), for testing checksum validators.

Query parameters

curl https://api.real-fake-data.com/v1/nl/company