API Documentation

Integrate our fake identity generator into your applications with our simple REST API.

Rate Limit

100/min

Countries

11 Supported

Method

POST

Generate Identity

Request

POSThttps://api.fakeidentitygenerator.com/generate

Headers:

Content-Type: application/json
Accept: application/json

Body:

{
  "gender": "male",    // "male", "female", or "random"
  "country": "us"      // Country code (optional)
}

Supported Countries

usukcaaudefrjpcninmxru

Rate Limit

The API is limited to 100 requests per minute per IP. Exceeding this limit will result in a 429 Too Many Requests response.

Response

{
  "address": {
    "city": "Springfield",
    "country": "United States",
    "state_abbreviation": "IL",
    "state_name": "Illinois",
    "street": "123 Main St",
    "zip": "62701"
  },
  "blood_type": "O+",
  "credit_card": {
    "cvv": "123",
    "expiry": "12/25",
    "number": "6527828340160949",
    "provider_bank": "Discover"
  },
  "dob": {
    "age": 28,
    "date": "1995-05-15",
    "day": "15",
    "month": "05",
    "zodiac": "Taurus"
  },
  "email": "[email protected]",
  "gender": "male",
  "height": {
    "cm": 175,
    "feet": 5,
    "inches": 9,
    "m": 1.75
  },
  "name": "John Doe",
  "national_id": "123-45-6789",
  "phone": "+1 (555) 123-4567",
  "photo_url": "/avatar/men/32",
  "weight": {
    "kg": 75,
    "lbs": 165
  }
}

Error Handling

400

Bad Request

Invalid request body or missing required fields.

429

Too Many Requests

Rate limit exceeded. Please wait before making more requests.

500

Internal Server Error

An unexpected error occurred. Please try again later.

Code Examples

JS/TS

JavaScript / TypeScript

const generateIdentity = async (gender: 'male' | 'female', country?: string) => {
  const response = await fetch('https://api.fakeidentitygenerator.com/generate', {
    method: 'POST',
    headers: {
      'Content-Type': 'application/json',
      'Accept': 'application/json'
    },
    body: JSON.stringify({ gender, country })
  });

  if (!response.ok) {
    throw new Error(`API request failed: ${response.statusText}`);
  }

  return response.json();
};

// Example usage
const identity = await generateIdentity('male', 'us');
console.log(identity);

Python

import requests

def generate_identity(gender: str, country: str = 'us') -> dict:
    response = requests.post(
        'https://api.fakeidentitygenerator.com/generate',
        json={'gender': gender, 'country': country},
        headers={'Accept': 'application/json'}
    )
    response.raise_for_status()
    return response.json()

# Example usage
identity = generate_identity('female', 'uk')
print(identity)

CURL

cURL

curl -X POST \
  https://api.fakeidentitygenerator.com/generate \
  -H 'Content-Type: application/json' \
  -H 'Accept: application/json' \
  -d '{"gender": "male", "country": "us"}'