API reference

The same seed returns the same person. The birthday is fixed, so the age goes up as time passes.

With num above 1, the first person uses your seed and the rest use seeds derived from it. Every person carries its own seed, so you can fetch any one of them again alone.

A seed is repeatable against one reference dataset. The response names it in meta.dataset.

Errors return JSON with a code you can test and a message you can show.

{
  "error": {
    "code": "invalid_num",
    "message": "num must be from 1 to 100. You sent 500."
  }
}

time is the generation time in seconds, people is the list, and meta names the engine and dataset. The example below leaves out married and timeline to keep it short.

{
  "time": 0.004,
  "people": [
    {
      "age": 71,
      "birth_day": "1955-03-05",
      "children": {
        "children": false
      },
      "education": {
        "education_highest": "Bachelor's degree"
      },
      "email": {
        "status": true,
        "address": "carmen.vazquez@gmail.com"
      },
      "employment": {
        "status": "Employed",
        "company": {
          "size": "Large"
        },
        "schedule": {
          "start": "7:00",
          "end": "18:00",
          "days": {
            "text": "Monday-Friday",
            "day_nums": [1, 2, 3, 4, 5]
          }
        },
        "commute": {
          "time": 36,
          "type": "car",
          "description": "Carmen has a rural 36 minute commute by car.",
          "text": "by car"
        }
      },
      "favorite_color": "Blue",
      "housing": {
        "owns": true,
        "type": "House",
        "status": "Homeowner"
      },
      "income": {
        "num": 3.8,
        "min": 150000,
        "max": 200000,
        "amount": 162322
      },
      "location": {
        "id": "1600000US2577890",
        "density": "rural",
        "location": "West Springfield Town, Massachusetts",
        "population": "28391",
        "city": "West Springfield Town",
        "state": "Massachusetts",
        "state_abbrev": "MA",
        "location_exact": {
          "lat": 42.092957100999996,
          "lng": -72.64807676
        },
        "races": {
          "white": "24508",
          "black": "939",
          "asian": "4",
          "american_indian": "1",
          "hispanic": 3475
        }
      },
      "name_first": "Carmen",
      "name_last": "Vazquez",
      "personality": {
        "bigFive": {
          "openness": 56,
          "conscientiousness": 55,
          "extraversion": 42,
          "agreeableness": 50,
          "neuroticism": 47
        }
      },
      "pets": {
        "has_pets": true,
        "pets": ["Bird"]
      },
      "phone": {
        "phone": true,
        "smartphone": false,
        "carrier": "AT&T"
      },
      "physical": {
        "gender": "Male",
        "height": {
          "cm": 171,
          "imperial": {
            "ft": 5,
            "in": 7
          }
        },
        "weight": {
          "kg": 64,
          "lbs": 141,
          "bmi": 22,
          "bmiDescription": "Healthy Weight"
        },
        "hair_color": "Brown",
        "eye_color": "Brown",
        "sexuality": "Heterosexual",
        "handedness": "Right Handed",
        "vision": {
          "color_vision": true
        },
        "lactose_tolerance": true,
        "race": "Hispanic",
        "pronouns": {
          "personal": "he",
          "possessive": "his",
          "objective": "him"
        },
        "penis_size": {
          "cm": 15,
          "imperial": {
            "ft": 0,
            "in": 6
          }
        },
        "piercing": {
          "earlobe": false
        },
        "blood_type": "B+",
        "allergies": ["Penicillin"],
        "has_allergies": true
      },
      "religion": "Catholic",
      "religiousity": 33,
      "seed": 12345,
      "smoking": {
        "smoking": false
      },
      "social_media": {
        "uses_social_media": true,
        "platforms": ["Facebook", "YouTube", "Reddit"],
        "platform_count": 3
      },
      "summary": "Carmen Vazquez is a 71 year old hispanic male. He lives in West Springfield Town, Massachusetts, a rural city of 28,000 people. Carmen works at a large company and commutes by car.",
      "swim_ability": true,
      "tendencies": {
        "musicGenres": ["Pop", "Country"],
        "podcastAffinity": 0,
        "drinking": {
          "drinking": true
        }
      },
      "vehicles": {
        "has_vehicle": true,
        "count": 2,
        "primary_transport": "Personal Vehicle"
      },
      "veteran": {
        "is_veteran": true,
        "branch": "Marines",
        "service_period": "Vietnam Era"
      },
      "wallet": {
        "credit_cards": [
          {
            "num": "3675394150182975",
            "type": "American Express",
            "prefix": 3,
            "name": "Carmen Vazquez",
            "date": "16/28",
            "cvv": 500
          },
          {
            "num": "5141044754060280",
            "type": "Master Card",
            "prefix": 5,
            "name": "Carmen Vazquez",
            "date": "04/29",
            "cvv": 882
          },
          {
            "num": "4692019975126231",
            "type": "Visa",
            "prefix": 4,
            "name": "Carmen Vazquez",
            "date": "24/31",
            "cvv": 698
          },
          {
            "num": "4034542091485279",
            "type": "Visa",
            "prefix": 4,
            "name": "Carmen Vazquez",
            "date": "07/27",
            "cvv": 226
          },
          {
            "num": "4165340580917907",
            "type": "Visa",
            "prefix": 4,
            "name": "Carmen Vazquez",
            "date": "30/29",
            "cvv": 176
          },
          {
            "num": "6092659878783314",
            "type": "Discover",
            "prefix": 6,
            "name": "Carmen Vazquez",
            "date": "20/27",
            "cvv": 857
          }
        ],
        "cash": 24,
        "misc": []
      }
    }
  ],
  "meta": {
    "jsonapi": {
      "version": 3
    },
    "engine": "upstream",
    "dataset": "upstream"
  }
}

Every field of a person, grouped as in the response. Nested fields use dotted paths.

The API is free and needs no key. For API keys and higher rate limits, use the LifeSim listing on RapidAPI.

Try requests in the playground.