# faker.dev

> Free API and MCP server for realistic fake test data: names, emails, addresses, phone numbers, card numbers, dates, IDs and more (86 fields) in 109 locales, as JSON, NDJSON, CSV or SQL. No sign-up or API key. Seeded, so the same request returns the same rows.

## Use it

- [Generator](https://faker.dev/): build a dataset in the browser and copy or download it.
- [API reference](https://faker.dev/docs): OpenAPI docs for every endpoint. Schema at https://faker.dev/openapi.json
- MCP server: `https://faker.dev/mcp` (Streamable HTTP, no auth). Tools: `generate_fake_data`, `list_fake_data_fields`.

## HTTP API

`GET https://faker.dev/v1/generate`

- `fields`: comma-separated field names. `column:field` names a column, e.g. `signup:date_this_year`.
- `count`: rows, 1 to 1000 (default 10).
- `locale`: e.g. `en_US` (default), `de_DE`, `ja_JP`. Comma-separate several to mix them row by row.
- `seed`: integer. Repeat it to get identical rows. Omitted means random; the seed used is returned in the `X-Faker-Seed` header.
- `format`: `json` (default), `ndjson`, `csv` or `sql`. SQL also takes `table`, `dialect` (`postgres`, `mysql`, `sqlite`) and `create_table=true`.

`POST https://faker.dev/v1/generate` takes the same options as a JSON body; `fields` may be an object mapping column names to fields.

Example: `https://faker.dev/v1/generate?fields=id,name,email,city&count=5&seed=42&format=csv`

Other endpoints: `GET /v1/fields` (every field with an example), `GET /v1/locales`.

Limits: 1000 rows, 40 fields and 20000 cells (rows × fields) per request; 60 requests per minute per IP.

## Fields

### Person

- `name`: Full name
- `first_name`: Given name
- `last_name`: Family name
- `prefix`: Honorific, like Dr. or Mx.
- `suffix`: Name suffix, like Jr. or PhD
- `job`: Job title
- `date_of_birth`: Birth date for an adult aged 18 to 80
- `ssn`: National ID number in the locale's format
- `passport_number`: Passport number

### Contact

- `email`: Email address
- `safe_email`: Email at example.com/.net/.org, so it can never reach anyone
- `free_email`: Email at a free provider like gmail.com
- `company_email`: Email at a company domain
- `phone_number`: Phone number in the locale's format
- `country_calling_code`: International dialing prefix, like +44

### Internet

- `user_name`: Username
- `password`: Random 12-character password
- `url`: Website URL
- `domain_name`: Domain name
- `slug`: URL slug, like share-bag-could
- `ipv4`: IPv4 address
- `ipv6`: IPv6 address
- `mac_address`: MAC address
- `user_agent`: Browser user-agent string

### Location

- `address`: Full postal address (may span lines)
- `street_address`: Street address
- `building_number`: Building number
- `city`: City
- `state`: State, province or region (some locales only)
- `state_abbr`: State abbreviation, like CA (some locales only)
- `postcode`: Postal code
- `country`: Country name
- `country_code`: Two-letter country code
- `latitude`: Latitude
- `longitude`: Longitude
- `timezone`: IANA time zone, like Europe/Paris

### Company

- `company`: Company name
- `company_suffix`: Company suffix, like LLC or GmbH
- `catch_phrase`: Marketing catch phrase
- `bs`: Business buzzword phrase
- `ein`: US Employer Identification Number (some locales only)

### Finance

- `credit_card_number`: Card number that passes the Luhn check (not a real card)
- `credit_card_provider`: Card network, like VISA 16 digit
- `credit_card_expire`: Expiry date as MM/YY
- `credit_card_security_code`: CVV security code
- `iban`: International bank account number
- `swift`: SWIFT/BIC bank code
- `aba`: US ABA routing number
- `currency_code`: ISO 4217 currency code, like EUR
- `currency_name`: Currency name
- `price`: Amount between 0.01 and 999.99
- `pricetag`: Formatted price, like $12.99

### Date & time

- `date`: Date since 1970, as YYYY-MM-DD
- `datetime`: Timestamp within the last five years
- `date_this_year`: Date in the current year
- `date_this_decade`: Date in the current decade
- `past_date`: Date in the last 30 days
- `future_date`: Date in the next 30 days
- `time`: Time of day, as HH:MM:SS
- `unix_time`: Unix timestamp in seconds
- `iso8601`: ISO 8601 timestamp
- `day_of_week`: Weekday name
- `month_name`: Month name
- `year`: Year

### Text

- `word`: Single word
- `sentence`: Sentence
- `paragraph`: Paragraph
- `text`: Up to 200 characters of text

### Identifiers

- `id`: Row number starting at 1
- `uuid4`: Random UUID
- `ean13`: EAN-13 barcode number
- `isbn13`: ISBN-13 book number
- `md5`: MD5 hex digest
- `sha256`: SHA-256 hex digest
- `license_plate`: Vehicle license plate in the locale's format
- `vin`: Vehicle identification number

### Other

- `boolean`: true or false
- `integer`: Whole number from 0 to 10,000
- `color_name`: Color name, like ForestGreen
- `hex_color`: Hex color, like #9d3f50
- `emoji`: Emoji
- `file_name`: File name
- `file_extension`: File extension
- `mime_type`: MIME type
- `http_status_code`: HTTP status code
- `language_name`: Language name

## Notes

- All values are random. Card numbers pass the Luhn check but are not real cards.
- Privacy and terms: https://faker.dev/privacy