Skip to content

Person Address Form ​

Field reference for person address records. A person can have multiple addresses of different types.

Fields ​

Backed by core.person_addresses.

FieldColumnTypeRequiredNotes
Address IDperson_address_idUUIDAutoPrimary key
Personperson_idUUID (FK)YesParent person record
Address Typeaddress_type_idSelect (Lookup)YesADDRESS_TYPE
Address Line 1address_line_1Text(255)NoNullable in the database
Address Line 2address_line_2Text(255)No
Address Line 3address_line_3Text(255)No
CitycityText(100)No
State/Provincestate_provinceText(100)No
Postal Codepostal_codeText(20)No
Countrycountry_codeText(3)NoAn ISO code, not an FK to a country table
Is Primaryis_primaryBooleanYesPrimary address for the person
Is Currentis_currentBooleanYesThe currency flag
Effective Dateeffective_dateDateNoAddresses are the one contact type ODS dates
End Dateend_dateDateNo
Legacy Address IDlegacy_address_idIntegerAutoColleague/ODS source key

There is no notes column.

Currency is not fully imported

Addresses carry real effective dates from ODS, but ADDR_RELATION_STATUS — the flag saying whether an address is still the person's — has never been imported. Roughly 48,500 former addresses therefore read as current.

Contact records are end-dated, never deleted

is_current is the currency flag — there is no is_active column on any contact record. Removing a value sets is_current = false and stamps end_date; the row stays so the history survives. This holds through the admin API too. Contact values are also not unique: some 50,000 people share a phone number and 3,700 share an email, so key on the row id plus person_id, never on the value itself.

Address Type Values ​

CodeDescriptionNotes
PERMANENTPermanent/HomeLegal home address
MAILINGMailingWhere mail is sent
CAMPUSCampus/LocalOn-campus or local address
BILLINGBillingFor financial correspondence
EMERGENCYEmergency ContactEmergency contact address

Computed Fields (Read-Only) ​

FieldDescription
Full AddressMulti-line formatted address
City State ZipCity, State Postal Code
Country NameFull country name

Validation Rules ​

  1. Person must exist before adding addresses
  2. Only one address per type can be Is Primary = true
  3. State/Province required for US, Canada, Mexico addresses
  4. Postal Code required for US addresses
  5. End Date must be on or after Effective Date

Student Information System Documentation