Skip to main content
POST
/
api
/
ext
/
generic
/
data
/
generate
/
person
Generate fake person data
curl --request POST \
  --url https://app.spotzee.com/api/ext/generic/data/generate/person \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/x-www-form-urlencoded' \
  --data count=10 \
  --data locale=en \
  --data seed=12345
{
  "status": "success",
  "data": {
    "persons": [
      {
        "id": "550e8400-e29b-41d4-a716-446655440000",
        "firstName": "John",
        "lastName": "Doe",
        "email": "john.doe@example.com",
        "phone": "+1-555-123-4567",
        "birthDate": "1990-05-15",
        "address": {
          "street": "123 Main St",
          "city": "San Francisco",
          "state": "CA",
          "zipCode": "94105",
          "country": "USA"
        },
        "avatar": "https://avatars.githubusercontent.com/u/12345678",
        "jobTitle": "Software Engineer",
        "company": "Tech Corp",
        "bio": "Passionate developer with 10+ years of experience."
      }
    ],
    "generated": 1,
    "locale": "en",
    "seed": "12345"
  }
}

Authorizations

​
Authorization
string
header
required

Bearer token authentication. Use format: Bearer YOUR_API_KEY

Body

application/x-www-form-urlencoded
​
count
string

Number of persons to generate (1-100). Passed as string but must be numeric.

Pattern: ^[1-9]\d?$|^100$
Example:

"10"

​
locale
string

Locale for generated data (e.g., en, es, fr, de, pt_BR, zh_CN)

Example:

"en"

​
seed
string

Seed for deterministic generation. Same seed produces same results.

Example:

"12345"

Response

Successfully generated person data

​
status
enum<string>
required
Available options:
success
​
data
object
required