{
  "title": "VoterFile synthetic export field dictionary",
  "version": "2026-07-11",
  "data_classification": "synthetic demonstration data only",
  "warning": "The accompanying CSV files contain no real voter records. Field availability in an official voter file varies by jurisdiction and requester entitlement.",
  "files": {
    "synthetic-voter-file-sample.csv": {
      "row_grain": "one synthetic voter record",
      "fields": {
        "synthetic_record": "Always true; prevents confusion with real voter data.",
        "registration_id": "Fictional stable identifier beginning SYNTH-VF-.",
        "first_name": "Synthetic first-name placeholder.",
        "last_name": "Synthetic last-name placeholder.",
        "residential_address": "Fictional demonstration street address.",
        "residential_city": "Fictional demonstration city.",
        "residential_state": "Two-letter state code used for the sample workflow.",
        "residential_zip": "Invalid placeholder ZIP; never use for delivery.",
        "county": "Fictional county label.",
        "precinct": "Fictional precinct identifier.",
        "party_preference": "Example registration-party value where the source jurisdiction releases it.",
        "registration_status": "Example active or inactive source status.",
        "registration_date": "Synthetic ISO calendar date.",
        "year_of_birth": "Synthetic year only; some jurisdictions omit this field.",
        "permanent_vote_by_mail": "Example Y/N source flag where available.",
        "participation_count": "Synthetic count of elections with recorded participation; never ballot choice.",
        "turnout_propensity": "Synthetic 0–100 VoterFile v1 ranking; not a calibrated probability or support score."
      }
    },
    "synthetic-canvass-results-sample.csv": {
      "row_grain": "one synthetic contact attempt",
      "fields": {
        "synthetic_record": "Always true.",
        "contact_id": "Fictional contact-attempt identifier.",
        "registration_id": "Join key to the synthetic voter sample.",
        "packet_id": "Fictional walk-packet identifier.",
        "contacted_at": "Synthetic ISO timestamp including UTC offset.",
        "contact_method": "Example channel used for the contact attempt.",
        "contact_result": "Example canvass disposition.",
        "support_status": "Campaign-entered example status; not inferred from voter-file data.",
        "top_issue": "Campaign-entered example issue response.",
        "follow_up": "Example next-action code.",
        "canvasser_note": "Synthetic free-text demonstration note."
      }
    }
  }
}