Skip to main content

​
List identities

Retrieve all disposable identities for the authenticated user, with optional status filtering and aggregate stats. 
GET /api/identities
Authentication: Required Query parameters:
ParameterTypeRequiredDescription
statusstringNoFilter by status: active, paused, nuked
Response 200 OK: 
{
  "identities": [
    {
      "id": "ident_abc123",
      "user_id": "usr_xyz",
      "display_name": "Sandra Carter",
      "first_name": "Sandra",
      "last_name": "Carter",
      "username": "sandrac_92",
      "email_alias": "sandra.carter.7x@tempmail.dev",
      "phone_number": "+1 (555) 842-9163",
      "date_of_birth": "1992-03-15",
      "gender": "female",
      "address_line1": "1847 Oak Valley Dr",
      "address_city": "Portland",
      "address_state": "OR",
      "address_zip": "97205",
      "address_country": "US",
      "status": "active",
      "label": "Gaming forum burner",
      "notes": null,
      "used_for_service": "Steam",
      "created_at": "2026-03-04T12:00:00Z"
    }
  ],
  "stats": {
    "total": 5,
    "active": 3,
    "paused": 1,
    "nuked": 1
  }
}

​
Generate identity

Create a new disposable identity with realistic personal details. 
POST /api/identities
Authentication: Required CSRF: Required Rate limit: 10 requests per 60 seconds per user Request body: 
{
  "label": "Gaming forum burner",
  "service": "Steam",
  "generateEmail": true,
  "emailProvider": "simplelogin",
  "emailApiKey": "sl_api_key",
  "generatePhone": false,
  "country": "US",
  "gender": "female",
  "notes": "For Steam forums only"
}
FieldTypeRequiredDescription
labelstringNoHuman-readable label for the identity
servicestringNoTarget service name
generateEmailbooleanNoGenerate an email alias
emailProviderstringNosimplelogin, duckduckgo, or others
emailApiKeystringNoAPI key for email alias provider
generatePhonebooleanNoGenerate a phone number
countrystringNoCountry code: US (default), GB, CA
genderstringNomale, female, any (default)
notesstringNoPrivate notes
Response 201 Created: 
{
  "success": true,
  "identity": {
    "id": "ident_abc123",
    "display_name": "Sandra Carter",
    "first_name": "Sandra",
    "last_name": "Carter",
    "username": "sandrac_92",
    "email_alias": "sandra.carter.7x@tempmail.dev",
    "phone_number": "+1 (555) 842-9163",
    "date_of_birth": "1992-03-15",
    "status": "active",
    "created_at": "2026-03-04T12:00:00Z"
  }
}

​
Update identity

Change identity status (pause, resume, nuke) or update metadata. 
PATCH /api/identities/{id}
Authentication: Required CSRF: Required Rate limit: 30 requests per 60 seconds per user Request body: 
{
  "status": "paused"
}
StatusDescription
activeIdentity is usable
pausedTemporarily deactivated
nukedPermanently destroyed
Setting status to nuked is irreversible. The identity data is permanently marked as destroyed.
Response 200 OK: 
{
  "success": true,
  "identity": { ... }
}

​
Delete identity

Permanently remove an identity record from the database. 
DELETE /api/identities/{id}
Authentication: Required CSRF: Required Rate limit: 30 requests per 60 seconds per user Response 200 OK: 
{
  "success": true
}