API

Generate realistic fake identities programmatically for testing and development.

RESTJSONRate Limited

Overview

Base URL: https://www.fakegenerator.name

Authentication: API key via header

Rate limits: 60 requests/min per key

Data policy: All data is fictitious

Headers

X-API-Key: YOUR_KEY

Accept: application/json

Quick Start

curl -X GET \
  "https://www.fakegenerator.name/api/identity?country=us&gender=female" \
  -H "Accept: application/json"

The response is a JSON object containing a complete fake identity.

{
  "fullName": "Jordan Lee",
  "gender": "Female",
  "birthday": "1992-06-14",
  "age": 31,
  "email": "jordan.lee@anonmail.example",
  "phone": "+1 (415) 555-0147",
  "address": "4821 Willow Ridge Dr",
  "city": "San Francisco",
  "zipCode": "94107",
  "username": "jlee92",
  "password": "uJ9!q7wT",
  "creditCard": "4539 1488 0343 6467",
  "cvv": "193",
  "cardExpiry": "08/27"
}

Endpoint

GET /api/identity

Returns a single fake identity based on optional filters.

Query Parameters

gender

random | male | female (default: random)

country

us | uk | ca | au | de | fr | es | it | jp | cn (default: us)

Errors

400

Invalid query parameters

401

Missing or invalid API key

429

Rate limit exceeded