Skip to main content
Student addresses are stored as separate fields — street, apt, city, state, and ZIP — and can be verified against official NYC Geosupport data.

​
Address fields

If older records still have the apartment embedded in the street line (e.g. 690 Grand St Apt 4B), the system splits it on read. Re-saving or running NYC verify writes the separate apt field.

​
Where addresses are captured

Intake (NEW students)

Contact & Address section with paste, parse, and Verify with NYC Geoclient.

Bulk upload

Optional address, apt, city, state, zip columns in CSV.

All Students

Students → All Students (/admin/students/all) — edit address, verify batch, export with Apt column.

Duplicates review

Side-by-side address comparison for flagged and auto-detected pairs.

​
NYC Geoclient verification

When NYC_GEOCLIENT_SUBSCRIPTION_KEY (or NYC_GEOCLIENT_APP_KEY) is configured:
  1. Building lookup — Geoclient validates house number + street + borough/ZIP.
  2. Apartment preserved — unit/apt is not sent to Geosupport; it is re-attached after standardization.
  3. Saved metadata — verification status, warnings, coordinates, and addressStandardized are stored on the student.

​
Typical workflow (Data Lead)

Admin All Students page with Verified, Warning, and Not found address badges

All Students — NYC Geoclient banner, filters, and address status badges

1

Filter unverified addresses

Open Students → All Students. Filter by Address not yet verified or Needs review.
2

Verify and save

Run Verify & save this page or Verify unverified batch. Standardized street data is written; apt stays in apt.
3

Fix and re-verify

Use the pencil icon on a row to edit street/apt/city/ZIP, then verify again from the dialog.
4

Export for mail merge

Export CSV includes street, Apt, city, state, and ZIP as separate columns.

​
Address status badges

​
Duplicate matching uses addresses

The intake duplicate check and Students → Duplicates both compare home addresses: Auto-detection on the Duplicates page can surface pairs with same DOB + same address even when names do not fuzzy-match.

​
Paste and CSV formats

Paste examples (intake or edit dialog):
Bulk CSV — apt in its own column or embedded in address:
Accepted apt column aliases: apt, unit, suite, address2, AddressLine2.