API Documentation

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

Generate Identity

Request

POST https://api.fakeidentitygenerator.com/generate

Headers:

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

Body:

{
  "gender": "male" // or "female"
}

Rate Limit

The API is limited to 100 requests per minute. 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",
  "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

JavaScript/TypeScript

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

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

  return response.json();
};

// Example usage
try {
  const identity = await generateIdentity('male');
  console.log(identity);
} catch (error) {
  console.error('Error:', error);
}

Python

import requests

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

# Example usage
try:
    identity = generate_identity('female')
    print(identity)
except requests.exceptions.RequestException as e:
    print(f"Error: {e}")

cURL

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