Field types

DataMaker ships with 50+ built-in field types. Each one knows how to generate a single realistic value, optionally honouring a locale or a range. This page lists them all.

Names

Type	What you get	Locale-aware
`first_name`	A first name	✓
`last_name`	A last name	✓
`full_name`	First + last, optionally with title	✓
`username`	`firstname.lastname`-style handle
`job_title`	A plausible job title	✓
`company`	A company name	✓
`prefix`	Mr / Mrs / Dr / Frau / Herr / Mme	✓

Identity & contact

Type	Notes
`email`	Plausible email; can be derived from `first_name` + `last_name`.
`phone`	Country-correct format, including international prefixes.
`address`	Street + number + postcode + city in the chosen locale.
`street`	Street + number only.
`city`	A real city in the chosen country.
`postcode`	Country-correct postal code format.
`country`	Country name; can also output an ISO 3166-1 alpha-2 code.
`ssn`	Country-correct national ID (US SSN, German Steueridentifikationsnr…).
`tax_id`	VAT / USt-ID format for the locale’s country (passes checksum).

Identifiers

Type	Format
`uuid`	RFC 4122 v4 UUID.
`iban`	Country-correct IBAN, MOD-97 valid.
`bic`	SWIFT / BIC code.
`credit_card`	Luhn-valid 16-digit number; optional brand filter.
`imei`	15-digit IMEI, Luhn-valid.
`mac_address`	`xx:xx:xx:xx:xx:xx`.
`ip_address`	IPv4 or IPv6.

Numeric & money

Type	Notes
`number`	Integer in `[min, max]`. Defaults `1..100`.
`float`	Float in `[min, max]` with configurable decimals.
`currency`	Money amount with 2 decimals; pair with `currency_code`.
`percent`	`0..100` float, optionally decimal-formatted.

Dates & time

Type	Notes
`date`	ISO date in a configurable range.
`datetime`	ISO 8601 datetime, optional timezone.
`date_of_birth`	Date with an age constraint (e.g. 18-65 years ago).
`time`	`HH:MM:SS`.

Booleans, picks, words

Type	Notes
`boolean`	`true` or `false`. Configurable bias.
`enum`	Pick from your own list of values; optionally weighted.
`words`	N random words.
`sentence`	A plausible sentence.
`paragraph`	A plausible paragraph.
`lorem`	Lorem ipsum.

Web & files

Type	Notes
`url`	An `https://…` URL, optionally on a chosen domain.
`domain`	A bare domain.
`slug`	Kebab-case slug derived from a configurable noun bag.
`color`	Hex `#rrggbb` or named CSS color.
`mime_type`	A real MIME type.
`file_path`	A plausible filesystem path.

Smart / dynamic types

Type	Notes
`ai`	Free-text prompt the agent honours per field. Slow but flexible.
`derived`	Compute from other fields with a tiny template syntax: `{{first}}@{{company}}.com`.
`regex`	Generate values matching a regex. Useful for codes and barcodes.
`python`	Run a snippet of Python and return its result. See Python fields.
`template`	Nest another template here. See Nested objects.
`api_response`	Field value comes from a live API call.
`db_response`	Field value comes from a connected database.
`mapped`	Map an upstream field through a lookup.
`custom`	Bring-your-own list of values.

Common options

Most field types accept a small set of common options:

nullable — emit null with a configurable probability.
unique — guarantee no duplicates within a single generation.
sensitive — mark this field as PII; see Sensitive fields.
locale — override the template-wide locale for one field.

Type-specific options (range, brand, country, format) live next to the relevant type above.

Listing types programmatically

curl https://api.datamaker.automators.com/types \
  -H "Authorization: Bearer $DM_API_KEY"

Returns the full catalogue with options schemas. The MCP server exposes the same data as a list_types tool.